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 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 协议简单但功能有限,无命名空间、不支持复杂类型嵌套、调试困难。现代项目建议优先考虑:
- restful API(jsON over HTTP)+ PSR-7/PSR-15(如 Slim、laravel、symfony)
- gRPC(高性能、强契约、多语言)
- 如果必须用 XML-RPC,可考虑第三方库如 mehdi-khalili/xmlrpc(纯 PHP 实现,兼容 PHP 8+)
对于新项目,不建议从零手写 XML-RPC;对遗留系统集成,则上述函数方式足够清晰可控。