PHPRPC 2.1 是一套讓 JavaScript 呼叫 PHP 遠端函式的 RPC 方案。透過 AJAX 客戶端,前端可以在不重新載入頁面的情況下,呼叫伺服器端方法並取得序列化結果。與 2.0 版相比,2.1 版在使用方式上大致相同,但增加了對引用參數傳遞的支援。
若遠端函式採取引用參數傳遞,需要在呼叫前將該函式的 ref 屬性設為 true。此屬性預設為 false。實務上建議在客戶端物件的 onready 事件中完成設定,確保服務已載入且函式已註冊。
典型流程如下:先建立 PHPrpc_client 物件,再呼叫 use_service 指定伺服器位址;等待 onready 觸發後,即可呼叫遠端函式。若需要非同步回呼,可為函式設定 callback;若需要同步結果,也可將 async 設為 false。
var rpc = PHPrpc_client.create("rpc");
rpc.use_service("https://domain.com/phprpc/server.php");
rpc.onready = function() {
rpc.someMethod_callback = function(result, args, output) {
if (result instanceof PHPrpc_error) {
alert(result.errstr);
} else {
alert(result);
}
};
rpc.someMethod();
};
客戶端會透過 PHP_Serializer 處理參數與回值的序列化。若伺服器回傳錯誤,結果會是 PHPrpc_error 物件,可讀取 errno 與 errstr。若啟用加密,客戶端會先取得加密參數,再進行 xxtea 加解密與 Base64 編碼處理。
AJAX 版 PHPRPC 客戶端的價值在於把遠端 PHP 函式封裝成近似本地 JavaScript 呼叫的體驗。開發時應特別注意服務位址、加密模式、引用參數與錯誤回呼,才能穩定整合。