PHP 8.2 编译安装 xmlrpc 扩展必须显式添加 --with-xmlrpc 参数，否则 php.ini 中启用 extension=xmlrpc 会报“unable to load dynamic library”；需确认 php-build 配置、php.ini 路径、extension_dir 及依赖库（如 libxml2），并注意 PHP 8.2+ 已禁用部分函数别名。
phpenv 本身不负责启用 PHP 扩展，它只管理 PHP 版本和编译流程；xmlrpc 扩展是否可用，取决于你编译 PHP 时是否传入 --with-xmlrpc 参数，以及编译后生成的 php.ini 是否启用了对应模块。
编译新版本 PHP 时必须加 --with-xmlrpc
这是最关键的一步。如果你用 phpenv install 8.2.15 编译安装 PHP，而没提前配置好编译选项，xmlrpc 就不会被编译进去 —— 后续在 php.ini 里加 extension=xmlrpc 会直接报错 “unable to load dynamic library”。
- 确认
php-build插件已安装（~/.phpenv/plugins/php-build存在） - 编辑默认配置文件：
vim ~/.phpenv/plugins/php-build/share/php-build/default_configure_options - 在参数列表中加入
--with-xmlrpc（注意：PHP 8.2+ 不再支持--with-xmlrpc=shared，直接写--with-xmlrpc即可静态编译） - 如果还用到
libxml相关功能（如simplexml），确保--enable-libxml和--with-libxml-dir也存在（多数系统默认启用，但 Alpine 等精简环境需显式指定）
装完后检查 php.ini 是否自动启用了 xmlrpc
部分 php-build 配置模板会在编译后自动生成 extension=xmlrpc.so 行并写入 php.ini，但不是所有版本都这么做。别依赖“自动”，要自己查。
- 运行
phpenv which php找到当前激活版本的二进制路径，再执行php --ini查出加载的php.ini位置 - 打开该
php.ini，搜索xmlrpc；如果没有，手动添加一行：extension=xmlrpc（PHP 7.4+ 可省略.so后缀） - 注意：不要写成
extension=php_xmlrpc.dll（那是 Windows 的命名，Linux/macOS 下无效） - 改完后必须重启 PHP-FPM 或 Apache，CLI 模式下直接生效
php -m | grep xmlrpc 返回空？先排除三个常见原因
即使编译加了参数、php.ini 也写了 extension，仍可能看不到模块 —— 多半卡在这几个环节：
立即学习“PHP免费学习笔记（深入）”；
-
phpenv rehash没执行：切换版本后未刷新 shims，php命令可能指向旧版本（执行后看which php是否落在~/.phpenv/shims/php） -
extension_dir路径错误：用php -i | grep extension_dir查实际路径，再确认xmlrpc.so文件是否存在（通常在$(php-config --extension-dir)下） - 依赖缺失：
ldd $(php-config --extension-dir)/xmlrpc.so | grep "not found"可暴露缺libxml2或libcurl的问题（尤其在 CentOS Stream 或自定义容器中）
最易被忽略的一点：PHP 8.2+ 默认禁用 xmlrpc 的函数别名（如 xmlrpc_encode_request），但扩展本身仍可用；若你依赖 PEAR 的 XML_RPC 类，得单独 composer require phpxmlrpc/polyfill-xmlrpc —— 这和 phpenv 无关，是运行时兼容性问题。
