PHP创建SoapClient时遇SOAP-ERROR: Schema解析未解析ref属性问题

当使用PHP的SoapClient类加载WSDL文件与某系统进行SOAP交互时，遇到错误：
SOAP-ERROR: Parsing Schema: unresolved element 'ref' attribute 'http://get_xxxx_response.xxx.xx.xxxx.xxxx.com:HEADER'

相关定义与代码 #

XSD文件中的命名空间定义 #

<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema"
    xmlns="http://get_xxxx_response.xxx.xx.xxxx.xxxx.com"
    targetNamespace="http://get_xxxx_response.xxx.xx.xxxx.xxxx.com">
. . .
</xs:schema>

WSDL文件中的命名空间声明 #

<wsdl:definitions name="SERVICE_NAME"
. . .
xmlns:SERVICE_ACTION_NAME="http://get_xxxx_response.xxx.xx.xxxx.xxxx.com"
. . .
</wsdl:definitions>

调用的PHP代码 #

<?php

error_reporting(-1);
ini_set('display_errors', 1);

$context = [
    'local_cert'    => 'xxxx',
    'passphrase'    => 'xxxx',
    'trace' => true
];
$path = 'PATH_TO_THEWSDL';
try {
    $soapclient = new SoapClient($path, $context);
} catch (Exception $e) {
    echo $e->getMessage();
}

已知条件：同一WSDL在SOAP UI中可正常使用，PHP版本为8.2.10。

解决方向 #

• 检查XSD中HEADER元素的完整性：确认该元素在对应命名空间下是否被正确定义，有无拼写错误，或引用的外部XSD是否被正确导入到WSDL中。SOAP UI对Schema解析更宽松，PHP SoapClient则要求严格。
• 验证WSDL命名空间映射一致性：确保WSDL中使用SERVICE_ACTION_NAME前缀引用该命名空间元素时，前缀与XSD默认命名空间的绑定关系无误，且Schema部分已正确导入对应XSD。
• 禁用WSDL缓存：PHP默认缓存WSDL，可能因旧缓存导致解析错误。在创建SoapClient时添加'cache_wsdl' => WSDL_CACHE_NONE到上下文数组，强制重新加载WSDL。
• 检查PHP SOAP扩展配置：临时通过ini_set('soap.wsdl_cache_enabled', 0);禁用缓存，同时确认soap.extensions等配置未限制Schema解析。
• 预处理本地WSDL/XSD文件：将WSDL和依赖XSD下载到本地，检查命名空间引用是否有误（比如http://get_xxxx_response.xxx.xx.xxxx.xxxx.com:HEADER中的冒号是否为笔误），手动修正路径确保元素可被正确解析。
• 开启详细异常信息：在SoapClient参数中添加'exceptions' => true，获取更具体的解析错误细节。

内容的提问来源于stack exchange，提问作者Nikola