simplexml_load_string()解析失败返回false而非空数组;需检查返回值、用libxml_get_errors()捕获错误,避免依赖json_encode中转,正确处理属性、重复节点及编码问题。

simplexml_load_string() 解析失败返回 false 而不是空数组
PHP 原生解析 XML 最常用的是 simplexml_load_string(),但它返回的是 SimpleXMLElement 对象,不是数组。直接 json_decode(json_encode($xml), true) 是常见“快捷方案”,但有隐患:当 XML 有属性(@attributes)、文本混合节点、空标签或重复子节点时,结果结构不可控,甚至丢失数据。
真正安全的做法是手动遍历转换,尤其在处理第三方接口返回的 XML 时:
- 用
simplexml_load_string($xml, 'SimpleXMLElement', LIBXML_NOCDATA)加载,LIBXML_NOCDATA避免 CDATA 被当作对象子节点干扰结构 - 检查返回值是否为
false,并用libxml_get_errors()捕获具体错误(如编码不匹配、标签未闭合) - 不要依赖
json_encode中转——它会把属性扁平化进同级键,且无法区分<item>text</item>和<item/>
带属性的 XML 必须显式提取 @attributes
XML 中的属性(如 <user id="123" type="admin"></user>)在 SimpleXMLElement 中以 @attributes 键存在,但不会自动合并到元素内容里。若忽略这点,转出的数组会丢掉所有属性信息。
实操建议:
立即学习“PHP免费学习笔记(深入)”;
- 对每个节点,先调用
->attributes()获取属性对象,再用(array)强转为关联数组 - 若节点同时有属性和子节点,需将属性存为
_attr或@键,避免和子节点名冲突(例如子节点也有id) - 示例片段:
$attrs = $node->attributes();<br>if ($attrs) {<br> $arr['_attr'] = (array) $attrs;<br>}
重复子节点(同名多个)会被覆盖,必须检测 count()
当 XML 出现多个同名子节点(如 <list><item>a</item><item>b</item></list>),SimpleXMLElement 默认只暴露第一个——除非你显式用 ->item 得到对象数组,或用 ->children() + 循环。否则转数组后只剩一个 item。
判断逻辑必须写死:
- 用
count($node->item)判断是否多个;值为 1 表示单个对象,大于 1 才是对象数组 - 不能依赖
is_array($node->item),因为单个节点时它返回对象,多个时才返回数组 - 统一转成数组:无论单个还是多个,都包装成
array($node->item)再遍历,或用iterator_to_array($node->item, false)
字符编码错误导致解析中断,优先用 UTF-8 并声明 encoding
XML 声明中的 encoding(如 <?xml version="1.0" encoding="GB2312"?>)若与实际内容不符,simplexml_load_string() 会静默失败(返回 false)。PHP 7.4+ 默认只接受 UTF-8 输入,其他编码需提前转换。
稳妥做法:
- 用
mb_detect_encoding($xml, ['UTF-8', 'GB2312', 'GBK', 'BIG5'], true)探测原始编码 - 用
mb_convert_encoding($xml, 'UTF-8', $detected)统一转码后再解析 - 如果 XML 没声明 encoding,且内容含中文却解析失败,大概率是 GBK/GB2312,别硬试
iconv
复杂点在于:有些 XML 声明是 UTF-8,但 HTTP 响应头或文件存储用了其他编码,这种必须按源头修正。别指望函数自动猜对。



















