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 参数











