PHP：如何用SoapHeader生成符合要求的SOAP XML？

我之前对接SOAP服务的时候也踩过命名空间前缀和Header配置的坑，刚好能精准解决你遇到的问题——去掉Envelope里的ns1/ns2前缀，同时生成带SOAP-ENV:mustUnderstand="1"的Action节点。下面是具体的实现步骤和代码示例：

核心思路 #

要达到你的需求，关键要做好两点：

1. 正确配置SoapClient的命名空间和SOAP版本，避免自动生成不必要的ns前缀
2. 手动构建符合要求的SoapHeader，指定SOAP-ENV命名空间和mustUnderstand属性

完整代码实现 #

1. 初始化SoapClient（避免自动生成ns前缀） #

首先创建SoapClient时，要明确指定SOAP版本（因为mustUnderstand="1"是SOAP 1.1的格式）、服务的目标命名空间和端点地址：

// 替换成你的服务WSDL地址或直接使用非WSDL模式
$wsdl = 'http://your-service-url?wsdl';
$clientOptions = [
    'soap_version' => SOAP_1_1, // 对应mustUnderstand="1"的格式
    'uri' => 'http://your-target-service-namespace.com', // 服务的核心命名空间
    'location' => 'http://your-service-endpoint-url', // 服务调用地址
    'trace' => true, // 开启trace，方便查看生成的XML请求
    'exceptions' => true,
    'cache_wsdl' => WSDL_CACHE_NONE, // 禁用WSDL缓存，调试时更方便
];

$soapClient = new SoapClient($wsdl, $clientOptions);

2. 构建带mustUnderstand的Action头 #

接下来创建符合要求的SoapHeader，注意要使用SOAP-ENV的官方命名空间：

// SOAP-ENV的标准命名空间
$soapEnvNamespace = 'http://schemas.xmlsoap.org/soap/envelope/';
// 替换成你实际需要的Action值
$actionValue = 'http://your-service-action/TargetActionName';

// 创建Action头，第四个参数控制actor，第五个参数就是mustUnderstand的值
$actionHeader = new SoapHeader(
    $soapEnvNamespace,
    'Action',
    $actionValue,
    false, // actor参数，不需要的话设为false
    1 // mustUnderstand=1，对应SOAP 1.1的要求
);

// 给客户端设置SOAP头
$soapClient->__setSoapHeaders([$actionHeader]);

3. 调用服务并验证XML #

最后调用服务方法，通过__getLastRequest()查看生成的XML是否符合要求：

// 构造你的请求参数
$requestParams = [
    'RequestParam1' => 'value1',
    'RequestParam2' => 'value2'
];

try {
    $response = $soapClient->TargetServiceMethod($requestParams);
    // 打印生成的请求XML（调试用）
    echo "生成的请求XML:\n" . htmlspecialchars($soapClient->__getLastRequest()) . "\n";
} catch (SoapFault $e) {
    echo "调用出错: " . $e->getMessage();
}

关键细节说明 #

• 命名空间前缀问题：如果Envelope里仍然出现ns1/ns2，大概率是因为请求Body的参数自动绑定了前缀。这时候可以用SoapVar手动包装参数，强制指定命名空间：

  $requestParams = new SoapVar(
      ['RequestParam1' => 'value1'],
      SOAP_ENC_OBJECT,
      null,
      null,
      'TargetRequestElement',
      'http://your-target-service-namespace.com'
  );
  

• SOAP版本匹配：如果你的服务要求SOAP 1.2，那mustUnderstand的值要设为true（字符串），同时soap_version改为SOAP_1_2。

预期生成的XML结构 #

最终生成的XML会类似这样（符合你的要求）：

<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="http://your-target-service-namespace.com">
    <SOAP-ENV:Header>
        <SOAP-ENV:Action SOAP-ENV:mustUnderstand="1">http://your-service-action/TargetActionName</SOAP-ENV:Action>
    </SOAP-ENV:Header>
    <SOAP-ENV:Body>
        <ns1:TargetRequestElement>
            <ns1:RequestParam1>value1</ns1:RequestParam1>
        </ns1:TargetRequestElement>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

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