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免费学习笔记(深入)”;
Sylius开源电子商务平台是一个开源的 PHP 电子商务网站框架,基于 Symfony 和 Doctrine 构建,为用户量身定制解决方案。可管理任意复杂的产品和分类,每个产品可以设置不同的税率,支持多种配送方法,集成 Omnipay 在线支付。功能特点:前后端分离Sylius 带有一个强大的 REST API,可以自定义并与您选择的前端或您的微服务架构很好地配合使用。如果您是 Symfony
- 使用
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;对遗留系统集成,则上述函数方式足够清晰可控。










