使用 PHPRPC 實現 AJAX 安全登錄：輕量級跨域 RPC 框架實戰

什麼是 PHPRPC？

PHPRPC 是一個輕量、安全、跨語言、跨平台、跨域的遠程過程調用協議框架。核心理念：「只做一件事，並把它做好」——專注於數據傳輸，將傳輸做到極致。

優勢：

• 支援複雜對象傳輸、引用參數傳遞
• 支援內容輸出重定向、分級錯誤處理
• 支援 Session、服務導向架構
• 跨域調用原生支援（無需 JSONP/CORS 折騰）

快速上手：5 分鐘實現「字串 SHA1 計算」服務

服務端（PHP）：僅 4 行代碼

<?php
require_once("../php/phprpc_server.php");

$server = new PHPRPC_Server();
$server->add("sha1");  // 發布 PHP 內置 sha1 函數
$server->start();
?>

客戶端（HTML + JS）

<!DOCTYPE html>
<html xmlns="https://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>計算 SHA1</title>
<script type="text/javascript" src="../js/compressed/phprpc_client.js"></script>
<script type="text/javascript">
var rpc = new PHPRPC_Client('sha1.php', ['sha1']);

function $(id) { return document.getElementById(id); }

function showResult(result) {
    $('sha1').value = result;
}

function sha1() {
    var input = $('sha1').value;
    $('sha1').value = "Loading...";
    rpc.sha1(input, showResult); // 異步調用，回調處理結果
}
</script>
</head>
<body>
<input type="text" id="sha1" />
<input type="button" value="計算 SHA1" onclick="sha1()" />
</body>
</html>

核心機制解析

1. 客戶端初始化

var rpc = new PHPRPC_Client('sha1.php', ['sha1']);

• 參數 1：服務端地址（支援相對/絕對路徑，支援跨域）
• 參數 2：需調用的服務端方法名陣列（即使只有一個也要用陣列）

2. 遠程方法調用

rpc.sha1(input, showResult);

• 直接以服務端方法名作為 rpc 對象方法調用
• 參數 1：傳遞給服務端的參數值
• 參數 2：回調函數，服務端執行完成後自動調用，接收返回值

進階應用：實現安全登錄

服務端：登錄邏輯封裝

<?php
require_once("phprpc_server.php");

class AuthService {
    public function login($username, $password) {
        // 實際項目中：驗證用戶名密碼、生成 Token、設置 Session
        $user = User::findByUsername($username);
        if ($user && password_verify($password, $user->password_hash)) {
            $_SESSION['user_id'] = $user->id;
            return ['success' => true, 'token' => $user->generateToken()];
        }
        return ['success' => false, 'message' => '用戶名或密碼錯誤'];
    }
    
    public function logout() {
        session_destroy();
        return ['success' => true];
    }
}

$server = new PHPRPC_Server();
$server->add(new AuthService()); // 發布整個類的公共方法
$server->start();

客戶端：登錄表單交互

<script>
var rpc = new PHPRPC_Client('auth.php', ['login', 'logout']);

function doLogin() {
    var username = $('#username').val();
    var password = $('#password').val();
    $('#loginBtn').prop('disabled', true).val('登錄中...');
    
    rpc.login(username, password, function(result) {
        $('#loginBtn').prop('disabled', false).val('登錄');
        if (result.success) {
            // 登錄成功：跳轉或更新 UI
            window.location.href = '/dashboard';
        } else {
            // 顯示錯誤
            $('#errorMsg').text(result.message).show();
        }
    });
}
</script>

PHPRPC 核心優勢總結

適用場景

• 微服務架構中 PHP 服務間調用
• 前後端分離項目的 API 層
• 需要跨域調用的嵌入式應用/Widget
• legacy 系統現代化改造的過渡層

PHPRPC 雖非主流選擇，但其「專注傳輸、極簡介面」的設計哲學在特定場景下極具價值，尤其適合快速構建內部 RPC 服務或跨域 AJAX 應用。