phpEnv下安装SOAP扩展需手动编译：先确认当前版本及路径，进入对应源码ext/soap目录，用phpize和php-config编译安装，再在php.ini中添加extension=soap.so并重启PHP，最后配置soap.wsdl_cache_dir等参数。
phpEnv 下安装 SOAP 扩展不能直接套用系统包管理器命令（如 apt install php-soap），因为 phpEnv 是独立编译、多版本共存的 PHP 环境管理工具，扩展必须针对当前激活的 PHP 版本手动编译安装。
确认当前 phpEnv 使用的 PHP 版本和路径
先搞清你实际在用哪个 PHP 版本，否则装错位置白忙活。phpEnv 的每个版本都隔离在自己的目录里，php --ini 显示的配置路径和扩展目录跟系统默认完全不同。
- 运行
phpenv version查看当前激活版本（例如8.1.25） - 执行
php --ini，重点记下 “Loaded Configuration File” 路径（如/home/user/.phpenv/versions/8.1.25/etc/php.ini） - 再运行
php-config --extension-dir获取真实扩展存放路径（如/home/user/.phpenv/versions/8.1.25/lib/php/extensions/no-debug-non-zts-20210902/） - 别依赖
which php或系统/usr/bin/php—— 那不是 phpEnv 管的
进入 ext/soap 目录编译安装（Linux/macOS）
phpEnv 本身不自带预编译的 soap.so，必须用源码编译。前提是当初编译 PHP 时启用了 --enable-libxml（默认开启），否则会报 configure: error: libxml2 not found。
- 找到你 phpEnv 对应版本的源码目录，通常在
~/.phpenv/sources/（如/ ~/.phpenv/sources/8.1.25/） - 进入
ext/soap子目录：cd ~/.phpenv/sources/8.1.25/ext/soap - 执行
phpize（确保用的是当前版本的 phpize：~/.phpenv/versions/8.1.25/bin/phpize） - 运行
./configure --with-php-config=~/.phpenv/versions/8.1.25/bin/php-config --enable-soap -
make && make install，成功后终端会输出类似Installing shared extensions: /home/user/.phpenv/versions/8.1.25/lib/php/extensions/no-debug-non-zts-20210902/
启用扩展并验证加载
编译完只是把 soap.so 放进目录，还得让 PHP 主动加载它。phpEnv 不会自动写配置，这步必须手动做，且只对当前版本生效。
- 用编辑器打开刚才
php --ini显示的php.ini文件 - 在文件末尾添加一行：
extension=soap.so（注意：不是extension=php_soap.dll，那是 Windows 的） - 保存后，**必须重启 PHP 进程**：如果你用 php-fpm，运行
phpenv rehash && pkill -f 'php-fpm' && php-fpm；如果是 CLI 模式，直接运行新命令即可 - 验证是否生效：
php -m | grep soap应该输出soap；或者php -r "var_dump(extension_loaded('soap'));"返回bool(true)
WSDL 缓存配置容易被忽略
SOAP 客户端默认启用 WSDL 缓存，但 phpEnv 环境下 soap.wsdl_cache_dir 默认指向系统临时目录（如 /tmp），权限或磁盘空间问题会导致 SoapClient 初始化失败，错误类似 SOAP-ERROR: Parsing WSDL: Couldn't load from ...。
- 在
php.ini中显式设置缓存目录，指向当前用户可写的路径：soap.wsdl_cache_dir="/home/user/.phpenv/versions/8.1.25/tmp" - 创建该目录：
mkdir -p /home/user/.phpenv/versions/8.1.25/tmp - 调试阶段建议关掉缓存：
soap.wsdl_cache_enabled=0，避免改了 WSDL 却没生效 - 这个配置项必须写在
php.ini全局段，不能放在[soap]小节里——PHP 会忽略
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
