phpenv下xmlrpc扩展默认不启用，需在php-build编译时添加--with-xmlrpc参数；可通过修改~/.phpenv/plugins/php-build/share/php-build/default_configure_options文件追加该选项，并安装libxml2-dev等依赖后重装PHP版本。
phpenv 下 xmlrpc 扩展默认不启用，必须手动编译时加入
phpenv 本身不控制扩展开关，它只管理 PHP 版本；xmlrpc 是否可用，取决于你用 php-build 编译该版本时是否启用了 --with-xmlrpc。PHP 官方源码中 xmlrpc 是可选模块，不是默认内置——哪怕你在 phpinfo() 里看到 libxml 已启用，也不代表 xmlrpc 函数（如 xmlrpc_encode_request）就可用。
- 检查当前 PHP 是否真有 xmlrpc：运行
php -m | grep xmlrpc，无输出即未启用 - 确认编译参数是否含
--with-xmlrpc：执行php-config --configure-options，搜索关键词 - 若缺失，需重装该 PHP 版本：先
phpenv uninstall 8.2.10（举例），再通过自定义配置重编译
如何让 phpenv 编译时自动启用 xmlrpc
关键在修改 php-build 的默认配置文件，避免每次手动加参数。这个文件路径通常是 ~/.phpenv/plugins/php-build/share/php-build/default_configure_options。
- 在该文件末尾追加一行：
--with-xmlrpc - 如果系统缺少依赖，在 Ubuntu/Debian 上需先装：
sudo apt install libxml2-dev libssl-dev；RHEL/CentOS 则是sudo dnf install libxml2-devel openssl-devel - 重新安装 PHP 版本，例如：
phpenv install 8.2.10，此时会自动带上--with-xmlrpc - 验证：装完后运行
php -r "var_dump(function_exists('xmlrpc_encode_request'));"，返回bool(true)才算成功
xmlrpc 扩展启用后仍报错的常见原因
即使编译进去了，运行时还可能失败，多数和环境链路有关，而非代码本身。
-
Call to undefined function xmlrpc_encode_request()：99% 是 PHP CLI 和 Web SAPI（如 Apache 或 PHP-FPM）用了不同版本的 PHP，检查which php和phpinfo()中的Loaded Configuration File路径是否一致 - 客户端调用返回空或超时：不是扩展问题，而是服务端没正确处理
php://input，或 HTTP 头缺失Content-Type: text/xml - 服务器端解析失败，
xmlrpc_decode()返回false：常见于响应体被意外截断、gzip 压缩未关闭、或 Nginx 配置了fastcgi_buffering off导致 XML 流损坏
不用重编译也能临时补救：polyfill 方案
如果你无法重装 PHP（比如生产环境受限），可以用 phpxmlrpc/polyfill-xmlrpc 替代原生扩展。它完全兼容函数签名，无需改业务代码。
立即学习“PHP免费学习笔记（深入）”；
- 通过 Composer 安装：
composer require phpxmlrpc/polyfill-xmlrpc - 确保
vendor/autoload.php被引入，之后所有xmlrpc_*函数（如xmlrpc_encode_request、xmlrpc_decode）都能正常调用 - 注意：polyfill 不支持
xmlrpc_server_create等服务端函数，仅覆盖客户端常用函数 - 性能略低（纯 PHP 实现），但对调试、CI/CD 或临时过渡足够可靠
