最近在开发一个项目，需要频繁地检查模板引擎生成的HTML结构。然而，输出的HTML总是挤成一团，没有任何缩进和换行，导致我在浏览器开发者工具中调试时非常痛苦。每次都需要手动格式化，或者复制到外部工具中处理，效率低下且容易出错。我尝试过一些PHP内置的HTML格式化方法，但它们的问题在于会“修正”HTML，而不是仅仅“美化”，这与我需要查看原始输出以定位问题的初衷相悖。正当我为此感到头疼时，我发现了gajus/dindent这个Composer库，它完美地解决了我的困扰。
gajus/dindent是一个专门用于HTML缩进的PHP库，它的核心理念是：只负责缩进，不触碰你的HTML结构。这意味着，无论你的HTML是否完全符合规范，dindent都会忠实地为你添加缩进，让你能清晰地看到模板引擎究竟生成了什么，这对于调试来说至关重要。它不会像DOMDocument或Tidy那样尝试修复或删除不合法的HTML标签，而是保留原始的、甚至是“错误”的结构，仅仅通过美化排版来提升可读性。
如何使用 gajus/dindent 解决问题
使用gajus/dindent非常简单，首先通过Composer将其安装到你的项目中：
<code class="bash">composer require gajus/dindent</code>
安装完成后，你就可以在PHP代码中轻松地使用它来格式化HTML字符串了。下面是一个简单的示例：
<code class="php"><?php
require 'vendor/autoload.php'; // 引入Composer自动加载文件
use Gajus\Dindent\Indenter;
$indenter = new Indenter();
$uglyHtml = '<html><head></head><body><div><script>console.log("test");</script><p>Hello <span>World</span>!</p><p><span>立即学习</span>“<a href="https://pan.quark.cn/s/7fc7563c4182" style="text-decoration: underline !important; color: blue; font-weight: bolder;" rel="nofollow" target="_blank">PHP免费学习笔记（深入）</a>”；</p><div class="aritcle_card flexRow">
<div class="artcardd flexRow">
<a class="aritcle_card_img" href="/ai/746" title="Vondy"><img
src="https://img.php.cn/upload/ai_manual/000/000/000/175679971943508.png" alt="Vondy" onerror="this.onerror='';this.src='/static/lhimages/moren/morentu.png'" ></a>
<div class="aritcle_card_info flexColumn">
<a href="/ai/746" title="Vondy">Vondy</a>
<p>下一代AI应用平台，汇集了一流的工具/应用程序</p>
</div>
<a href="/ai/746" title="Vondy" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span> </a>
</div>
</div><table><tr><td>Cell 1</td><td>Cell 2</td></tr></table></div></body></html>';
echo "<!-- 格式化前 -->\n";
echo $uglyHtml;
echo "\n\n<!-- 格式化后 -->\n";
$beautifiedHtml = $indenter->indent($uglyHtml);
echo $beautifiedHtml;
/*
输出：
<!-- 格式化前 -->
<html><head></head><body><div><script>console.log("test");</script><p>Hello <span>World</span>!</p><p><span>立即学习</span>“<a href="https://pan.quark.cn/s/7fc7563c4182" style="text-decoration: underline !important; color: blue; font-weight: bolder;" rel="nofollow" target="_blank">PHP免费学习笔记（深入）</a>”；</p><table><tr><td>Cell 1</td><td>Cell 2</td></tr></table></div></body></html>
<!-- 格式化后 -->
<html>
<head></head>
<body>
<div>
<script>
console.log('test');
</script>
<p>Hello <span>World</span>!</p><p><span>立即学习</span>“<a href="https://pan.quark.cn/s/7fc7563c4182" style="text-decoration: underline !important; color: blue; font-weight: bolder;" rel="nofollow" target="_blank">PHP免费学习笔记（深入）</a>”；</p>
<table>
<tr>
<td>Cell 1</td>
<td>Cell 2</td>
</tr>
</table>
</div>
</body>
</html>
*/</code>从上面的示例可以看出，原本挤成一团的HTML代码，经过gajus/dindent处理后变得井井有条，层级关系清晰可见。这对于快速定位HTML结构问题、调试CSS样式或JavaScript交互都非常有帮助。
gajus/dindent还提供了一些灵活的配置选项，例如你可以通过构造函数参数或setElementType方法来自定义缩进字符（默认为4个空格），或者指定哪些HTML元素应被视为“块级”或“内联”元素，以更好地适应你的代码风格和特殊需求。此外，它还提供了命令行工具，可以直接在终端中格式化HTML文件，非常方便。
总结其优势和实际应用效果
使用gajus/dindent之后，我的开发工作效率得到了显著提升：
- 代码可读性飙升： 告别了“代码墙”，HTML结构一目了然，不再需要眯着眼睛寻找标签的开闭。
- 调试效率翻倍： 无论是CSS样式错位，还是JavaScript无法正确选中DOM元素，都能迅速定位问题所在。因为格式化的HTML忠实地反映了原始输出，而不是一个被“修复”过的版本，这使得调试结果更加可靠。
- 轻量且无副作用： 它不会修改你的HTML内容，只负责美化，这使得它成为开发和测试环境的理想选择，无需担心引入额外的复杂性或意外的副作用。
- 集成简单： 借助Composer，引入和使用都非常便捷，几乎是零配置开箱即用。
总而言之，如果你也曾被模板引擎输出的杂乱HTML所困扰，那么gajus/dindent绝对值得一试。它用一种简单而高效的方式，解决了开发过程中的一个常见痛点，让你的PHP开发体验更加顺畅愉快。虽然它可能无法处理所有边缘情况（例如对HTML注释和IE条件注释的处理不尽完美），但在绝大多数日常开发场景中，它的表现都非常出色，足以成为你PHP开发工具箱中的一把利器。
