推荐使用PHP内置xmlrpc扩展处理XML-RPC,分三步:解析请求(php://input + xmlrpc_decode)、调度方法(映射method name到函数并call_user_func_array)、编码响应(xmlrpc_encode或xmlrpc_encode_fault),需设置Content-Type头。

PHP 处理 XML-RPC 请求和响应,推荐使用内置的 xmlrpc_encode()、xmlrpc_decode() 和 xmlrpc_server_call_method() 等函数,或更现代、更可控的方式:用 ext/xmlrpc 扩展(需启用)配合自定义服务器逻辑。不依赖第三方库也能稳定工作,关键是理解请求解析、方法分发与响应编码三步。
解析客户端 XML-RPC 请求
XML-RPC 请求是标准的 POST 请求,body 是符合规范的 XML。PHP 需读取原始输入并解码:
- 用
file_get_contents('php://input')获取原始 XML 字符串 - 调用
xmlrpc_decode($xml, 'UTF-8')将其转为 PHP 数组(含 method name 和 params) - 注意:若解码失败,
xmlrpc_decode()返回NULL,应返回标准 XML-RPC 错误响应
注册并调用对应处理方法
XML-RPC 不自动绑定方法,需手动映射 method name 到 PHP 函数:
- 定义一个方法调度数组,例如
$methods = ['sayHello' => 'handleSayHello'] - 从解码结果中取出
method_name,检查是否在调度表中存在 - 用
call_user_func_array()调用对应函数,传入参数数组 - 函数返回值将作为响应内容,建议统一返回关联数组(便于后续编码)
生成并返回 XML-RPC 响应
响应必须是格式严格、编码正确的 XML,并设置正确 Content-Type:
立即学习“PHP免费学习笔记(深入)”;
- 用
xmlrpc_encode($result)将返回值转为 XML 字符串(支持 int/string/array/struct 等基本类型) - 若出错,用
xmlrpc_encode_fault($code, $message)生成标准错误响应 - 输出前设头:
header('Content-Type: text/xml; charset=UTF-8'); - 直接
echo编码后的 XML 即可,无需额外包装
简易服务端示例(无框架)
以下是一个最小可行 XML-RPC 服务端片段:
function($a, $b) { return $a + $b; },
'demo.greet' => function($name) { return "Hello, $name!"; }
];
if (!isset($handlers[$method])) {
echo xmlrpc_encode_fault(2, "Method '$method' not supported");
exit;
}
try {
$result = call_user_func_array($handlers[$method], $params);
header('Content-Type: text/xml; charset=UTF-8');
echo xmlrpc_encode($result);
} catch (Exception $e) {
echo xmlrpc_encode_fault(3, $e->getMessage());
}
?>
注意:生产环境建议加输入校验、超时控制和日志记录;如需更高可靠性或复杂类型支持(如 datetime、base64),可考虑使用 Zend\XmlRpc 或 phpxmlrpc 库,但原生扩展已覆盖绝大多数场景。











