AMFPHP 實現 PHP 遠程過程調用 (RPC) 完整入門指南

什麼是 AMFPHP？

AMFPHP 是一個開源的 PHP 類庫，專門用於實現遠程過程調用（RPC，Remote Procedure Call）。它能讓 PHP 後端與多種前端技術無縫通信，包括：

• Flash / Flex Remoting (AMF 協議)
• JavaScript / Ajax (JSON 格式)
• XML 與 XML-RPC

RPC 核心概念

遠程過程調用（RPC）是一種客戶端與服務端交換數據的方式。開發者可以像調用本地方法一樣，直接呼叫遠端服務的方法、傳遞參數並接收返回結果，而無需關心底層的數據序列化、網絡傳輸與反序列化細節——這些複雜過程由框架自動完成。

AMFPHP 工作流程

1. 客戶端序列化請求：Flash/Flex 或 JavaScript 將方法調用與複雜數據對象序列化為 AMF/JSON/XML 格式。
2. 發送至網關：請求經 HTTP POST 發送到 gateway.php。
3. 服務端處理：AMFPHP 依次執行：
   • 反序列化請求數據
   • 定位對應的服務類（Service Class）
   • 實例化服務類
   • 執行安全檢查（可選）
   • 以指定參數調用目標方法
   • 將返回結果序列化
4. 響應客戶端：序列化後的結果經 HTTP 響應返回，客戶端反序列化後直接使用。

AMFPHP 支持複雜數據類型（對象、陣列、資源），甚至能直接返回 mysql_query 資源。若平台支持（如 Flash/Flex Remoting），還能處理循環引用與自定義類別映射。框架內建服務瀏覽器，方便在編寫客戶端代碼前測試服務；1.0.1 版新增代碼生成模板，1.9 beta 更支持 AMF3 協議。

快速入門：登錄示例

1. 服務端準備

將 amfphp 目錄放入項目根目錄（如 MyTest/amfphp），瀏覽器訪問 https://localhost/MyTest/amfphp/gateway.php 驗證安裝。修改 globals.php 指定服務類目錄：

$servicesPath = "../BusinessLogic/";

2. 編寫服務類 Login.php

<?php
class Login {
    public function doLogin($data) {
        $result = array();
        try {
            $name = array_shift($data);
            $pwd  = array_shift($data);
            if ($name === "phinecos" && $pwd === "123") {
                $result[] = "1";
                $result[] = "you are valid user!";
            } else {
                $result[] = "0";
                $result[] = "login failed";
            }
        } catch (Exception $ex) {
            $result[] = "-1";
            $result[] = $ex->getMessage();
        }
        return $result;
    }
}
?>

3. Flex 客戶端調用

import mx.controls.Alert;
import mx.rpc.remoting.mxml.RemoteObject;
import mx.rpc.events.*;

public var login_remoteObj:RemoteObject;

public function initLoginRemoteObject():void {
    this.login_remoteObj = new RemoteObject();
    this.login_remoteObj.source = "Login";
    this.login_remoteObj.destination = "amfphp";
    this.login_remoteObj.showBusyCursor = true;
    this.login_remoteObj.endpoint = "https://localhost/MyTest/amfphp/gateway.php";
    this.login_remoteObj.doLogin.addEventListener("result", loginHandler);
    this.login_remoteObj.doLogin.addEventListener("fault", faultHandler);
}

public function doLogin():void {
    var name:String = this.txtName.text;
    var pwd:String  = this.txtPassword.text;
    var data:Array = [name, pwd];
    this.login_remoteObj.getOperation("doLogin").send(data);
}

public function loginHandler(event:ResultEvent):void {
    var result:Array = event.result as Array;
    var flag:String = result[0];
    switch(flag) {
        case "0": Alert.show("登錄失敗: " + result[1]); break;
        case "1": Alert.show("登錄成功: " + result[1]); break;
        case "-1": Alert.show("異常: " + result[1]); break;
    }
}

public function faultHandler(event:FaultEvent):void {
    Alert.show("抱歉，發生錯誤！");
}

進階提示

• 生產環境請務必啟用安全過濾器，防止任意類實例化。
• 使用 AMF3 可大幅減小傳輸體積，提升性能。
• 服務類建議採用單一職責原則，每類只處理一個業務領域。

AMFPHP 讓 PHP 後端與富客戶端（Flex/Flash/Ajax）協作變得極其簡單，是構建 RIA（富互聯網應用）的經典選擇。