SoapClient 实例化需确保 WSDL 可访问且配置正确：检查重定向、HTTPS 证书（可禁用验证）、allow_url_fopen 状态（禁用则用本地 WSDL），并按需指定 soap_version；参数须严格匹配 WSDL 定义的嵌套结构与字段名，空值用 null；调试必开 trace，用 __getLastRequest/Response 对比 SoapUI。
PHP 的 SoapClient 怎么实例化才不报错
直接 new SoapClient 却提示 SOAP-ERROR: Parsing WSDL 或 Could not connect to host，大概率是 WSDL 地址没处理好。WSDL 可能是 HTTP 重定向、带认证、或服务器禁用了 allow_url_fopen。
- 先用
curl -I {wsdl_url}确认地址能通，且返回200 OK（不是 301/302） - 如果 WSDL 地址是 HTTPS 但证书异常，加选项：
['stream_context' => stream_context_create(['ssl' => ['verify_peer' => false, 'verify_peer_name' => false]])] - 若服务器关闭了
allow_url_fopen，必须把 WSDL 文件下载到本地，用本地路径（如'./service.wsdl'）初始化，不能传远程 URL - 某些老服务只支持 SOAP 1.1，需显式指定：
['soap_version' => SOAP_1_1]（默认是SOAP_1_2）
调用方法时参数怎么传才匹配 WSDL 定义
WSDL 里定义的函数入参通常是嵌套结构，比如 <xs:element name="request"><xs:complexType><xs:sequence><xs:element name="userId" type="xs:string"/>，这时不能直接传 ['userId' => '123']，而要按层级组织数组。
- 最外层元素名就是方法名后缀，例如 WSDL 中有
<operation name="getUserInfo">，且其input消息绑定了getUserInfoRequest元素，则应传：['getUserInfoRequest' => ['userId' => '123']] - 不确定结构时，用
$client->__getTypes()和$client->__getFunctions()查看实际期望格式 - 遇到
SOAP-ERROR: Encoding: object has no 'xxx' property，说明数组键名和 WSDL 要求的字段名大小写/下划线不一致，必须严格对照 - 空值要用
null，别用空字符串或''，否则可能被序列化为<xxx xsi:nil="true"/>而被服务端拒绝
__soapCall 和直接调用方法名有什么区别
两者底层一样，但行为有关键差异：直接调用（如 $client->getUserInfo(...)）会触发 PHP 的魔术方法 __call，自动包装参数；__soapCall 更底层，允许你绕过部分自动处理。
- 当方法名含特殊字符（如连字符、数字开头）无法直接调用时，必须用
__soapCall('get-user-info', [...]) - 需要手动控制 SOAP Header（如认证 token）时，
__soapCall的第 3 个参数可传['soapaction' => '', 'uri' => '', 'trace' => 1]，而直接调用不支持传这些选项 - 开启
'trace' => 1后，可用$client->__getLastRequest()和$client->__getLastResponse()查原始 XML，调试必开 - 注意：
__soapCall的第二个参数必须是索引数组，如[['userId' => '123']]，不是关联数组
如何处理常见错误：Authentication failed、Invalid XML or missing element
这类错误基本不是 PHP 问题，而是 SOAP 请求体与服务端契约不匹配。重点检查三处：Header、Body 结构、命名空间。
立即学习“PHP免费学习笔记（深入）”；
- 认证失败通常因没加 Header，用
$client->__setSoapHeaders($header)，其中$header是SoapHeader实例，namespace 必须和服务端要求一致（常是'http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd'） -
Invalid XML多半是数组嵌套少了一层，或字段名拼错；用__getLastRequest()复制 XML 到 SoapUI 验证是否合法 - 响应里出现
<faultstring>Server was unable to process request</faultstring>，不代表 PHP 报错，而是服务端逻辑拒绝，此时要看__getLastResponse()的完整内容，找<detail>里的具体原因 - 某些 .NET 服务强制要求
SOAPActionHTTP 头，此时必须用__soapCall并在 options 里设'soapaction' => 'http://tempuri.org/GetUserInfo'
