在使用 PHP 和 Java 操作 XML-RPC 時,如果 request 中包含中文字元,會被自動編碼成類似 欢欢 的樣式。環境為:PHP 內建的 XML-RPC API,以及 Apache 的 XML-RPC Java API。
起初以為是中文字元的編碼問題,嘗試用各種編碼方式來編碼中文字元,再交給 xmlrpc_encode_request(string method, mixed params) 函數產生 XML 格式的請求,但情況依舊。後來找到 sourceforge 上的 XML-RPC EPI 網站,才發現原來 PHP 文件裡給的函數少了一個可選參數!正確的寫法應該是:
string xmlrpc_encode_request(string method, mixed params [, array output_options])
output_options 的結構如下:
$output_options = array(
"output_type" => "XML",
"verbosity" => "pretty",
"escaping" => array("markup", "non-ascii", "non-print"),
"version" => "xmlrpc",
"encoding" => "utf-8"
);
// 或
$output_options = array("output_type" => "PHP");
原文說明如下:
經過測試,關鍵在於 "escaping" => array("markup") 這個值上。將第三個參數傳入如下值即可解決問題:
$output_options = array(
"output_type" => "XML",
"verbosity" => "pretty",
"escaping" => array("markup"),
"version" => "xmlrpc",
"encoding" => "utf-8"
);
也就是把預設會跳脫 non-ascii 的行為移除,中文便不會被編碼成實體參照。
Apache 提供的 API 似乎沒有類似 PHP 那樣的第三個參數,最後發現它提供了一個 Base64 類別,於是便將所有的中文字元在用戶端先用 Base64 編碼,request 到伺服器端後再用 Base64 解碼,如此一來問題也能解決。若讀者有更好的方法,也歡迎交流討論。