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

10次阅读

推荐使用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:

立即学习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),可考虑使用 ZendXmlRpcphpxmlrpc 库,但原生扩展已覆盖绝大多数场景。

text=ZqhQzanResources