PHP使用DOMDocument生成XML教程

本文深入解析了PHP中使用DOMDocument生成XML时的三大核心痛点：中文乱码的根源在于未提前声明文档编码（需在添加节点前设置`$doc->encoding = 'UTF-8'`）及未对中文内容进行`htmlspecialchars($str, ENT_XML1, 'UTF-8')`安全转义；格式化输出需同时启用`$doc->formatOutput = true`并关闭空白保留`$doc->preserveWhiteSpace = false`，且仅对新构建或重载后的结构生效；最后对比DOMDocument与SimpleXML的适用边界——前者适合复杂动态结构、命名空间和CDATA等高级场景，后者更轻量高效，适用于RSS、API响应等扁平化需求，帮助开发者避开编码陷阱、选对工具、少走弯路。

DOMDocument生成XML时中文乱码怎么办

直接用 DOMDocument 创建 XML，中文默认变问号或空格，根本原因是没声明编码且节点内容未转义。PHP 的 DOM 扩展默认按 UTF-8 处理，但如果你的源字符串是 GBK、或者没显式设置文档编码，saveXML() 就会出问题。

• 创建文档后立刻调用 $doc->encoding = 'UTF-8'（注意：必须在添加任何节点前设）
• 所有中文文本内容用 htmlspecialchars($str, ENT_XML1, 'UTF-8') 转义后再传给 createTextNode()，否则特殊字符如 &、 会破坏结构
• 输出前加 HTTP 头：header('Content-Type: application/xml; charset=UTF-8');，避免浏览器误判编码

appendChild() 报错“Not well-formed”或“Wrong Document Error”

常见于把一个文档里创建的节点，直接塞进另一个文档——DOM 节点有“归属文档”属性，跨文档移动必须用 importNode() 中转。

• 错误写法：$targetDoc->appendChild($sourceDoc->getElementsByTagName('item')->item(0));
• 正确写法：$imported = $targetDoc->importNode($sourceNode, true); $targetDoc->appendChild($imported);
• 如果只是简单拼接 XML 字符串，别硬套 DOM，改用 simplexml_load_string() + asXML() 更轻量

怎么让生成的XML带格式缩进（pretty print）

DOMDocument 默认输出是单行无缩进的，调试困难。启用格式化需两步：开开关 + 强制重排，但要注意它只对新插入节点生效，已有结构不会自动美化。

• 启用格式：$doc->formatOutput = true;
• 必须配合 $doc->preserveWhiteSpace = false;，否则空白文本节点会干扰缩进逻辑
• 如果 XML 已加载自字符串或文件，先调 $doc->loadXML($xml) 再设这两个属性，然后调 $doc->saveXML() 才有效

DOMDocument vs SimpleXML：什么情况该换方案

不是所有 XML 生成都得用 DOMDocument。它适合结构动态、节点嵌套深、要反复增删改查的场景；但如果你只是拼几个固定字段，SimpleXML 更快、代码更少、不易出错。

• 用 DOMDocument：需要精确控制命名空间、处理 CDATA、混合文本与子元素、或后续要解析回 DOM 操作
• 用 SimpleXMLElement：生成 RSS、配置片段、API 响应体这类扁平结构，示例：$xml = new SimpleXMLElement(''); $xml->addChild('title', htmlspecialchars('你好', ENT_XML1, 'UTF-8'));
• 注意：SimpleXML 不支持注释、处理指令（），也不允许同名兄弟节点靠索引区分——这些时候只能退回去用 DOMDocument

DOM 构建 XML 看似底层可控，但编码、节点归属、格式化这三处稍不注意就卡半天。真正难的不是写几行代码，而是搞清当前字符串的编码来源、目标 XML 的消费方是否严格校验格式、以及要不要留扩展余地——这些比函数调用顺序重要得多。

理论要掌握，实操不能落！以上关于《PHP使用DOMDocument生成XML教程》的详细介绍，大家都掌握了吧！如果想要继续提升自己的能力，那么就来关注golang学习网公众号吧！