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 字符),可能导致输出乱码或截断
完整示例代码
以下是最简可靠写法: