如何用PHP的XML-RPC创建一个服务器和客户端

11次阅读

php 7.4 可用内置 xmlrpc 扩展实现 XML-RPC 服务:server.php 注册 calc.add 和 system.time 方法,client.php 用 xmlrpc_encode_request 和 file_get_contents/curl 调用并解析响应。

如何用PHP的XML-RPC创建一个服务器和客户端

PHP 的 XML-RPC 功能在较新版本中已被移除(自 PHP 8.0 起 xmlrpc 扩展默认不启用,8.4 完全废弃),但如果你使用的是 PHP 7.x(如 7.4)或需维护旧系统,仍可通过内置的 xmlrpc_encode()xmlrpc_decode()xmlrpc_server_*() 系列函数实现轻量级 XML-RPC 服务。下面以 PHP 7.4 为基准,给出可直接运行的服务器与客户端示例。

搭建一个简单的 XML-RPC 服务器

XML-RPC 服务器本质是接收 POST 请求、解析 XML、调用对应方法、再返回 XML 响应的 PHP 脚本。无需框架,纯函数即可实现。

  • 启用 xmlrpc 扩展:确认 php.ini 中已取消注释 extension=xmlrpc,重启 Web 服务
  • 定义处理函数,例如加法和获取时间:

// server.php function add($params) {     $a = (int) $params[0];     $b = (int) $params[1];     return $a + $b; }  function get_time($params) {     return date('c'); }  // 注册方法映射 $methods = [     'calc.add' => ['function' => 'add'],     'system.time' => ['function' => 'get_time'] ];  // 创建服务器句柄 $server = xmlrpc_server_create();  // 注册所有方法 foreach ($methods as $method_name => $config) {     xmlrpc_server_register_method($server, $method_name, $config['function']); }  // 读取原始 POST 数据(XML-RPC 必须是 raw POST) $request = file_get_contents('php://input');  // 处理请求并输出响应 $response = xmlrpc_server_call_method($server, $request, null); header('Content-Type: text/xml'); echo $response;  xmlrpc_server_destroy($server);

将该脚本放在 Web 目录(如 http://localhost/server.php),即成为一个可被调用的 XML-RPC 端点。

编写 XML-RPC 客户端发起调用

客户端负责构造符合 XML-RPC 规范的请求体,发送 POST 请求,并解析返回的 XML 响应。

立即学习PHP免费学习笔记(深入)”;

  • 使用 xmlrpc_encode_request() 自动生成标准请求 XML
  • file_get_contents()cURL 发送 POST(推荐 cURL,可控性更强)
  • xmlrpc_decode() 解析返回结果

// client.php $request = xmlrpc_encode_request('calc.add', [5, 3]); $context = stream_context_create([     'http' => [         'method' => 'POST',         'header' => "Content-Type: text/xmlrnContent-Length: " . strlen($request),         'content' => $request,     ] ]);  $response = file_get_contents('http://localhost/server.php', false, $context); $result = xmlrpc_decode($response);  if (is_array($result) && xmlrpc_is_fault($result)) {     echo "错误:" . $result['faultString']; } else {     echo "结果:" . $result; // 输出 8 }

使用 cURL 客户端(更健壮的写法)

相比 file_get_contents,cURL 对超时、错误码、HTTP 头控制更好,适合生产环境。

$ch = curl_init('http://localhost/server.php'); curl_setopt($ch, CURLOPT_POST, true); curl_setopt($ch, CURLOPT_POSTFIELDS, xmlrpc_encode_request('system.time', [])); curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); curl_setopt($ch, CURLOPT_HTTPHEADER, ['Content-Type: text/xml']);  $response = curl_exec($ch); $http_code = curl_getinfo($ch, CURLINFO_HTTP_CODE); curl_close($ch);  if ($http_code === 200) {     $result = xmlrpc_decode($response);     if (!xmlrpc_is_fault($result)) {         echo "当前时间:" . $result;     } }

注意事项与替代建议

XML-RPC 协议简单但功能有限,无命名空间、不支持复杂类型嵌套、调试困难。现代项目建议优先考虑:

对于新项目,不建议从零手写 XML-RPC;对遗留系统集成,则上述函数方式足够清晰可控。

text=ZqhQzanResources