PHP DOMDocument怎么格式化保存XML

php 的 domDocument 需设置 formatOutput = true 且 preserveWhiteSpace = false 才能格式化输出 xml，PHP 5.5+ 可用 setIndentString() 自定义缩进，否则默认单空格；结构不完整或加载时残留空白会导致格式失效。

PHP 的 DOMDocument 默认保存 XML 时不会自动缩进或换行，看起来是“压缩”状态。要格式化保存（即带缩进、换行的可读 XML），关键在于启用 formatOutput 属性，并确保文档结构完整（有根节点、元素嵌套合理）。

启用 formatOutput 并设置 indent

formatOutput = true 是启用格式化的开关，但仅设这个还不够——DOMDocument 还需知道缩进用什么字符，默认是空格，你可以通过 setIndentString() 自定义（PHP 5.5+ 支持）：

• 必须在保存前设置：$doc->formatOutput = true;
• 推荐同时调用 $doc->preserveWhiteSpace = false;，避免空白文本节点干扰格式化逻辑
• 如需用 2 个空格缩进：$doc->setIndentString(' ');（PHP ≥ 5.5）

确保文档结构合法

格式化只对标准 DOM 结构生效。常见导致格式失效的情况包括：

• 加载 XML 时未关闭 preserveWhiteSpace，残留换行/空格文本节点，破坏层级判断
• 手动创建节点后未正确 append 到父节点，造成“游离”节点，save() 时可能忽略或报错
• XML 声明缺失或编码不匹配（如声明为 UTF-8 但内容含 GBK 字符），可能导致输出乱码或截断

完整示例代码

以下是最简可靠写法：

立即学习“PHP免费学习笔记（深入）”；

$doc = new DOMDocument('1.0', 'UTF-8'); $doc->preserveWhiteSpace = false; // 关键：清理原始空白 $doc->formatOutput = true; $doc->setIndentString('  '); // 可选，设为 2 空格  // 创建简单结构 $root = $doc->createElement('root'); $child = $doc->createElement('item', 'hello'); $root->appendChild($child); $doc->appendChild($root);  echo $doc->saveXML(); // 输出已格式化的 XML 字符串 // $doc->save('output.xml'); // 或保存到文件

注意兼容性与陷阱

低版本 PHP（如 5.3）不支持 setIndentString()，缩进固定为单个空格；若需 Tab 缩进，只能用正则替换输出字符串（不推荐，易破坏 CDATA 或属性值）。另外，loadXML() 加载含 DTD 或外部实体的 XML 时，建议先禁用外部实体加载，防止安全风险和解析失败：

• libxml_disable_entity_loader(true);（PHP
• 或使用 LIBXML_NOENT | LIBXML_NONET 作为 load 参数