SimpleXML添加子节点必须用addChild(),不能直接赋值;属性需用addAttribute()设置,不可用数组语法;中文和UTF-8内容无需额外编码,但需确保源文件及header声明UTF-8; addChild()返回新节点对象,支持链式调用。

SimpleXML添加子节点必须用 addChild(),不能直接赋值
很多人试图用 $xml->child = 'value' 添加新节点,结果发现不起作用——SimpleXML对象的属性赋值只对已存在的节点生效,新建子节点必须调用方法。这是因为 SimpleXML 的底层是只读 DOM 封装,addChild() 才是唯一安全的插入方式。
常见错误现象:Notice: Trying to get property 'xxx' of non-object 或静默失败,实际 XML 没有变化。
-
addChild()返回新创建的SimpleXMLElement对象,可链式调用继续添加子节点或属性 - 若节点名含特殊字符(如冒号命名空间前缀),需用花括号包裹:
$xml->addChild('{http://example.com}item') - 中文或 UTF-8 内容无需额外编码,但确保源文件和输出 header 都声明 UTF-8
给节点添加属性要用 addAttribute(),不是 array 语法
写成 $xml->item['id'] = '123' 看似直观,但会报错 Fatal error: Cannot use object of type SimpleXMLElement as array。属性操作和子节点操作是两个独立接口,混用必然失败。
使用场景:生成带 id、type、xmlns 等属性的标准 XML。
立即学习“PHP免费学习笔记(深入)”;
-
addAttribute()第一个参数是属性名,第二个是属性值,第三个可选命名空间 URI - 重复调用
addAttribute()可添加多个属性,顺序无关 - 不能用
addAttribute()添加默认命名空间(xmlns=""),需在根节点创建时指定
同时添加子节点和属性的典型写法
多数实际需求不是孤立加节点或属性,而是构造完整结构。关键点在于利用 addChild() 的返回值,避免反复查找节点。
$xml = new SimpleXMLElement('');
$item = $xml->addChild('item');
$item->addAttribute('id', '1001');
$item->addAttribute('status', 'active');
$content = $item->addChild('content', 'Hello & World');
$content->addAttribute('lang', 'zh-CN');
echo $xml->asXML();
输出中会正确转义 &,且所有属性紧贴对应起始标签,符合 XML 规范。注意:不能对文本内容节点(如 $content)再调用 addChild(),否则会覆盖文本——SimpleXML 不支持混合内容(text + child)。
修改已有节点内容与属性的注意事项
如果目标节点已存在,addChild() 会追加同名节点而非覆盖;想更新内容,应直接赋值:$xml->item = 'new value'。但属性只能通过 addAttribute() 设置,无法“修改”,重复设置同名属性会覆盖前值。
- 要清空某个属性?目前没有原生删除方法,需用
dom_import_simplexml()转为 DOM 节点后操作 - 批量添加大量子节点时,避免在循环里反复调用
asXML(),性能极差;先构建完再输出 - SimpleXML 不支持 XPath 修改,
xpath()方法只读,写操作必须靠 addChild / addAttribute 驱动
真正麻烦的是嵌套命名空间和 CDATA,SimpleXML 原生不支持直接写入 CDATA,必须降级到 DOM 才能处理——这点容易被忽略,直到生成的 XML 被解析器拒绝。
