本文旨在解决php多维数组向复杂soap xml结构序列化时遇到的“无法序列化结果”问题。通过深入理解soap xml的结构要求，包括命名空间和类型属性，文章将指导您如何构建符合特定xml schema的php关联数组。我们将利用`spatie/array-to-xml`库，详细演示其安装与使用方法，确保php数据能够准确无误地转换为soap兼容的xml，从而实现可靠的web服务通信。
在现代Web服务通信中，尤其是在使用SOAP协议时，将PHP中的复杂多维数组准确地序列化为符合特定XML Schema的XML结构是一项常见的挑战。直接的递归转换方法往往难以处理SOAP XML中对命名空间、属性（如xsi:type）和复杂类型数组的严格要求，从而导致“unable to serialize result”等错误。本文将详细介绍如何通过构建符合目标XML结构的PHP数组，并结合高效的第三方库，实现PHP多维数组到SOAP XML的无缝序列化。
SOAP（Simple Object Access Protocol）消息的XML结构通常比普通的XML更为复杂，它严格遵循WSDL（Web Services Description Language）中定义的Schema。一个典型的SOAP XML结构会包含：
例如，对于一个包含人员信息和物品列表的SOAP请求，其期望的XML结构可能如下所示：
<SOAP-ENV:Envelope SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/" xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/" xmlns:tns="http://ex.pt/soap/WebServices">
<SOAP-ENV:Body>
<ns1:Person xmlns:ns1="https://ex.pt/webservices">
<data xsi:type="tns:getPersonInfo">
<name xsi:type="xsd:string">John</name>
<surname xsi:type="xsd:string">Doe</surname>
<!-- ... 其他字段 ... -->
<address xsi:type="tns:getAddress">
<country xsi:type="xsd:string">france</country>
<city xsi:type="xsd:string">paris</city>
<post_code xsi:type="xsd:string">12345</post_code>
</address>
<items xsi:type="tns:getItems">
<item> <!-- 注意：这里的item标签可能需要xsi:type="tns:ItemInfo" -->
<name xsi:type="xsd:string">pillow</name>
<material xsi:type="xsd:string">cotton</material>
</item>
<!-- ... 其他item ... -->
</items>
</data>
</ns1:Person>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>要生成这样的XML，传统的递归转换函数需要进行大量修改以支持属性和命名空间，并且对于SOAP数组类型可能力不从心。
立即学习“PHP免费学习笔记（深入）”；
为了精确控制生成的XML，我们需要将PHP数组组织成一种能够明确表达XML元素名称、值、属性和命名空间的特定格式。spatie/array-to-xml等库通常采用一种约定，通过特殊的键名来区分这些XML组件。
假设我们有以下原始PHP数据：
$originalData = [
"name" => "John Doe",
"date" => "2021-11-30 00:00:00.000",
"job" => "developer",
"where_from" => "france",
"address" => [
"country" => "france",
"city" => "paris",
"vat_number" => "123456"
],
"items" => [
[
"cook" => "spoon",
"clean" => "vacuum"
]
]
];为了将其转换为上述SOAP XML结构，我们需要将$originalData转换为以下特殊结构的PHP数组。请注意，这里的转换不仅仅是简单的键值映射，更是对数据进行重塑以匹配XML Schema。例如，originalData['items'][0]['cook']被映射为items下的第一个item的name字段。
$soapFormattedData = [
'SOAP-ENV:Body' => [
'ns1:Person' => [
'info' => [ // 对应XML中的 <data> 标签，这里为了清晰，使用了 'info'，实际可能需要与XML标签名一致
"name" => ['_attributes' => ['xsi:type' => 'xsd:string'], '_value' => "John Doe"],
// 假设 'surname' 也是需要的字段，从原始数据中获取或补充
"surname" => ['_attributes' => ['xsi:type' => 'xsd:string'], '_value' => "Doe"],
"job" => ['_attributes' => ['xsi:type' => 'xsd:string'], '_value' => "developer"],
"from" => ['_attributes' => ['xsi:type' => 'xsd:string'], '_value' => "france"],
"address" => [
"country" => ['_attributes' => ['xsi:type' => 'xsd:string'], '_value' => "france"],
"city" => ['_attributes' => ['xsi:type' => 'xsd:string'], '_value' => "paris"],
"post_code" => ['_attributes' => ['xsi:type' => 'xsd:string'], '_value' => "123456"], // 原始数据是vat_number
'_attributes' => ['xsi:type' => 'tns:getAddress'] // address 标签的属性
],
"items" => [
// 对于数组中的每个元素，使用 '__custom:标签名:索引' 来创建同名标签
// 原始数据中的 "cook" 和 "clean" 被映射到 "name" 和 "material"
'__custom:item:1' => [
"name" => ['_attributes' => ['xsi:type' => 'xsd:string'], '_value' => "spoon"],
"material" => ['_attributes' => ['xsi:type' => 'xsd:string'], '_value' => "vacuum"],
],
// 如果有多个item，可以继续添加 '__custom:item:2' 等
'_attributes' => ['xsi:type' => 'tns:getItems'] // items 标签的属性
],
'_attributes' => ['xsi:type' => 'tns:getPersonInfo'] // data/info 标签的属性
],
'_attributes' => ['xmlns:ns1' => 'https://ex.pt/webservices'] // Person 标签的属性
]
]
];关键约定解释：
spatie/array-to-xml是一个功能强大且易于使用的PHP库，专门用于将PHP数组转换为XML字符串。它很好地支持了上述特殊数组结构。
通过Composer安装此库：
composer require spatie/array-to-xml
安装完成后，您可以使用以下代码将构建好的PHP数组转换为SOAP XML：
<?php
require 'vendor/autoload.php';
use Spatie\ArrayToXml\ArrayToXml;
// 上文构建的 $soapFormattedData 数组
$soapFormattedData = [
'SOAP-ENV:Body' => [
'ns1:Person' => [
'data' => [ // 对应XML中的 <data> 标签
"name" => ['_attributes' => ['xsi:type' => 'xsd:string'], '_value' => "John Doe"],
"surname" => ['_attributes' => ['xsi:type' => 'xsd:string'], '_value' => "Doe"],
"job" => ['_attributes' => ['xsi:type' => 'xsd:string'], '_value' => "developer"],
"from" => ['_attributes' => ['xsi:type' => 'xsd:string'], '_value' => "france"],
"address" => [
"country" => ['_attributes' => ['xsi:type' => 'xsd:string'], '_value' => "france"],
"city" => ['_attributes' => ['xsi:type' => 'xsd:string'], '_value' => "paris"],
"post_code" => ['_attributes' => ['xsi:type' => 'xsd:string'], '_value' => "123456"],
'_attributes' => ['xsi:type' => 'tns:getAddress']
],
"items" => [
'__custom:item:1' => [
"name" => ['_attributes' => ['xsi:type' => 'xsd:string'], '_value' => "spoon"],
"material" => ['_attributes' => ['xsi:type' => 'xsd:string'], '_value' => "vacuum"],
],
'_attributes' => ['xsi:type' => 'tns:getItems']
],
'_attributes' => ['xsi:type' => 'tns:getPersonInfo']
],
'_attributes' => ['xmlns:ns1' => 'https://ex.pt/webservices']
]
]
];
// 定义SOAP Envelope的根元素和其属性
$response = ArrayToXml::convert($soapFormattedData, [
'rootElementName' => 'SOAP-ENV:Envelope',
'_attributes' => [
'SOAP-ENV:encodingStyle' => 'http://schemas.xmlsoap.org/soap/encoding/',
'xmlns:SOAP-ENV' => 'http://schemas.xmlsoap.org/soap/envelope/',
'xmlns:xsd' => 'http://www.w3.org/2001/XMLSchema',
'xmlns:xsi' => 'http://www.w3.org/2001/XMLSchema-instance',
'xmlns:SOAP-ENC' => 'http://schemas.xmlsoap.org/soap/encoding/',
'xmlns:tns' => 'http://ex.pt/soap/WebServices'
],
], true, 'UTF-8');
echo $response;在ArrayToXml::convert()方法中：
执行上述代码将输出符合SOAP规范的XML字符串，该字符串可以用于SOAP请求的Body部分。
将PHP多维数组序列化为复杂的SOAP XML结构，尤其是当XML中包含命名空间、xsi:type属性和嵌套数组时，需要一种比简单递归转换更精细的方法。通过理解SOAP XML的严格要求，并采用spatie/array-to-xml库提供的特殊数组结构约定（如_attributes、_value和__custom:标签名:索引），开发者可以精确地控制生成的XML，确保其符合SOAP规范，从而实现与Web服务的成功交互。关键在于将原始PHP数据映射并重塑为与目标XML Schema完全一致的中间数组结构。
以上就是PHP多维数组到复杂XML结构的SOAP序列化实践的详细内容，更多请关注php中文网其它相关文章！
PHP怎么学习？PHP怎么入门？PHP在哪学？PHP怎么学才快？不用担心，这里为大家提供了PHP速学教程(入门到精通)，有需要的小伙伴保存下载就能学习啦！
Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号
529
收藏
