PHP如何处理XML-RPC请求和响应

2026-01-14

PHP如何处理XML-RPC请求和响应

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

php如何处理xml-rpc请求和响应

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：

谱乐AI

谱乐AI，集成 Suno、Udio 等顶尖AI音乐模型的一站式AI音乐生成平台。

下载

立即学习“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 库，但原生扩展已覆盖绝大多数场景。

https://www.php.cn/faq/1981415.html