如何用PHP的XML-RPC创建一个服务器和客户端
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 $me
thod_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 响应。
- 使用
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/xml\r\nContent-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；对遗留系统集成，则上述函数方式足够清晰可控。
