PHP-SOAP请求：如何将XML嵌套为参数？

嘿，我来帮你搞定这个SOAP请求的坑！你遇到的xml_structure错误，核心原因是SOAP客户端并不期望你直接传入原始XML字符串——它需要的是结构化的PHP数据（数组或对象），让客户端自动帮你生成符合要求的XML结构。下面分步骤给你拆解解决方案：

1. 先明确contract的预期结构 #

首先你得搞清楚接口WSDL里contract参数的定义（比如它是一个复杂类型，包含哪些子元素）。举个例子，如果WSDL里contract的预期XML是这样：

<contract>
  <contractId>1001</contractId>
  <contractName>年度服务协议</contractName>
  <effectiveDate>2024-06-01</effectiveDate>
</contract>

那对应的PHP数组应该写成：

$contract = [
    'contractId' => 1001,
    'contractName' => '年度服务协议',
    'effectiveDate' => '2024-06-01'
];

2. 把contract整合到请求参数里 #

接下来把这个结构化的$contract变量直接放到你的$params里，而不是传XML字符串：

// 原来的登录参数
$params = [
    'user_login' => '你的用户名',
    'user_password' => '你的密码',
    'contract' => $contract // 这里放结构化数组/对象，不是XML！
];

SOAP客户端会自动把这个数组转换成符合WSDL要求的XML节点结构，完全不需要你手动写XML。

3. 特殊情况：如果接口确实要求传原始XML（极少） #

如果接口明确要求contract参数是一个XML文本节点（这种情况非常少见），那你需要确保XML格式绝对正确，并且用PHP的XML对象来传递，而不是纯字符串：

// 先确保XML语法正确（闭合标签、特殊字符转义，比如&要写成&）
$contractXml = '<contract><contractId>1001</contractId><contractName>测试&amp;协议</contractName></contract>';

// 用SimpleXMLElement包装
$contract = new SimpleXMLElement($contractXml);

// 或者用DOMDocument
// $dom = new DOMDocument();
// $dom->loadXML($contractXml);
// $contract = $dom->documentElement;

// 整合到参数里
$params = [
    'user_login' => '你的用户名',
    'user_password' => '你的密码',
    'contract' => $contract
];

4. 调试技巧：查看实际发送的XML #

如果还是有问题，开启SOAP客户端的trace选项，看看实际发送的XML请求是什么，对比接口要求的结构找差异：

$client = new SoapClient('你的WSDL地址', ['trace' => true]);
try {
    $response = $client->你的接口方法名($params);
} catch (SoapFault $e) {
    // 打印发送的XML请求
    echo "实际发送的XML请求:\n" . $client->__getLastRequest();
    echo "\n错误信息: " . $e->getMessage();
}

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