PHP 8.4 已完全移除 xmlrpc 扩展，PHP 7.4 是最后一个稳定支持版本；使用前须确认扩展已启用并正确加载，手动解析 php://input，显式指定编码，严格校验类型与结构，并封装调试功能以定位 XML 层问题。
xmlrpc 扩展在 PHP 8.4 中已被完全移除，PHP 7.4 是最后一个稳定支持它的主流版本。如果你正在维护旧系统或对接遗留服务，必须确认运行环境是 PHP 7.x（推荐 7.4），否则直接写 xmlrpc_decode 会报 Fatal error: Uncaught Error: Call to undefined function xmlrpc_decode()。
确认 xmlrpc 扩展是否可用
别跳过这步——很多“教程跑不通”问题就出在这儿：
- 运行
php -m | grep xmlrpc，有输出才说明扩展已加载 - 若无输出，检查
php.ini是否启用了extension=xmlrpc（Windows 下可能是php_xmlrpc.dll） - Web 环境下需重启 Apache/Nginx + PHP-FPM，CLI 下改完 ini 后要重开终端
-
phpinfo()页面搜索 “xmlrpc”，看到模块信息才算真正生效
server.php 必须手动解析 php://input
xmlrpc_server_call_method() 不自动读取请求体，你得自己抓原始 XML：
- 用
file_get_contents('php://input')获取 POST body，不能依赖$_POST（XML-RPC 不走表单编码） - 解码前建议校验
Content-Type: text/xml，避免被非 XML 请求触发xmlrpc_decode()返回NULL -
xmlrpc_decode($xml, 'UTF-8')第二个参数必须显式传，否则中文参数可能乱码 - 解码失败时，应调用
xmlrpc_encode_fault(1, 'Invalid XML')并立即返回，不要继续执行
方法注册和 dispatch 容易漏掉错误处理
映射 method name 到函数只是开始，真实场景里这几处最常崩：
-
xmlrpc_server_register_method()的第三个参数（回调函数名）必须是全局可访问的，闭包、匿名函数、类方法（未绑定实例）都会导致Call to undefined function - 参数数组传给
call_user_func_array()前，务必检查长度和类型，比如calc.add要求两个整数，但客户端可能只传一个或传字符串 - 函数返回值只能是基本类型（
int/string/array），含资源、对象、闭包会令xmlrpc_encode()静默失败或返回空字符串 - 别忘了最后调用
xmlrpc_server_destroy($server)，否则长期运行的脚本会内存泄漏
客户端调用时 xmlrpc_encode_request 和解析要配对
用 xmlrpc_encode_request() 发请求看似简单，但 response 解析容易踩坑：
立即学习“PHP免费学习笔记（深入）”；
-
xmlrpc_encode_request('system.listMethods', [])生成的是标准 XML，但发送时要用file_get_contents()或 cURL POST，且 header 必须设Content-Type: text/xml - 响应 XML 解码后，先用
xmlrpc_is_fault($result)判断是否出错，再决定取$result['faultCode']还是$result['params'][0] - 如果服务器返回的是结构体（struct），PHP 数组键名默认小写，但某些旧客户端要求首字母大写字段名，需手动重映射
- 时间字段要用
xmlrpc_set_type($str, 'datetime')标记，否则xmlrpc_encode()当普通字符串处理，对方收不到 ISO8601 时间
xmlrpc 扩展不是“能跑就行”的玩具——它不验证参数契约、不提供日志钩子、错误信息极简。一旦客户端和服务端字段名拼错一个字母，或者时间格式没打标，问题就卡在 XML 层，看不出是哪边的锅。真要长期维护，建议把 xmlrpc_decode 和 xmlrpc_encode 封装成带调试输出的 wrapper 函数，至少让失败时能看到原始 XML 片段。 
