phpenv 下 soap 扩展需重编译启用 --enable-soap；WSDL 必须本地化且 allow_url_fopen 关闭时禁用远程加载；参数结构须严格匹配 WSDL 定义，调试必开 trace。
phpenv 环境下 soap 扩展默认不启用，必须手动编译时加入
phpenv 本身不管理扩展开关，它只负责切换 PHP 版本；soap 扩展是否可用，取决于你安装该 PHP 版本时是否启用了 --enable-soap。很多通过 phpenv + php-build 安装的 PHP，默认配置里没开这个选项，所以即使 php -m | grep soap 没输出，也不代表扩展不存在——只是没编译进去。
解决方法只有重新编译当前版本，并显式添加 --enable-soap：
- 先确认当前 PHP 版本：
phpenv version - 查出已安装版本名（如
8.2.12），然后执行：phpenv install --reinstall 8.2.12 - 关键一步：在 reinstall 前，修改
~/.phpenv/plugins/php-build/share/php-build/default_configure_options，确保包含--enable-soap（不是--with-soap，后者无效） - 重装完成后，运行
php -m | grep soap应输出soap
SoapClient 初始化失败：WSDL 地址不能直接传 HTTPS 或带重定向的 URL
在 phpenv 管理的 PHP 环境中，allow_url_fopen 默认是 off（尤其 CLI 模式），而 SoapClient 构造时若传远程 WSDL 地址（如 'https://api.example.com/service?wsdl'），会直接报 SOAP-ERROR: Parsing WSDL 或 Could not connect to host。
必须绕过远程加载：
立即学习“PHP免费学习笔记（深入）”；
- 用
curl -I https://api.example.com/service?wsdl先确认能拿到 200 响应体（不是 301/302） - 把 WSDL 内容保存为本地文件，例如
./service.wsdl - 初始化时传本地路径：
new SoapClient('./service.wsdl', ['trace' => true]) - 如果 WSDL 引用了外部 XSD 或 import，需一并下载并调整
<import location="...">为相对路径或本地地址
调用方法时参数结构不匹配 WSDL，报 Encoding: object has no 'xxx' property
WSDL 中定义的操作入参往往嵌套在命名元素里，比如 <element name="getUserInfoRequest">，而 PHP 数组键名必须与之完全一致（大小写、连字符、下划线都不能错）。
别猜，直接看实际要求：
- 初始化 client 后，立刻调用：
$client->__getFunctions()查方法签名，$client->__getTypes()查类型定义 - 常见错误：WSDL 要求传
['getUserInfoRequest' => ['userId' => '123']]，但你传了['userId' => '123']或['getUserInfo' => [...]] - 空字段必须用
null，不能用''或[]，否则可能触发xsi:nil="true"导致服务端拒绝 - 若方法名含连字符（如
get-user-info），无法直接$client->get-user-info()，必须用$client->__soapCall('get-user-info', [...])
调试必须开 trace，否则看不到真实请求和响应 XML
SoapClient 默认不记录通信内容，所有报错都笼统模糊。不开 trace，等于蒙眼修车。
初始化时务必加这个选项：
new SoapClient('./service.wsdl', ['trace' => true, 'exceptions' => true])- 出错后立即用：
echo $client->__getLastRequest();和echo $client->__getLastResponse(); - 对比 SoapUI 或 curl 发出的原始 XML，能快速定位字段名错误、命名空间缺失、SOAP Header 缺失等问题
- 注意：
__getLastRequest/Response只在当前请求生命周期有效，每次调用后要立刻读取，否则被下次覆盖
WSDL 结构、PHP 数组嵌套规则、trace 开关这三处，任何一个没对齐，SoapClient 就会静默失败或抛出毫无指向性的错误。别跳步骤。
