最近在开发一个项目，需要频繁地检查模板引擎生成的html结构。然而，输出的HTML总是挤成一团，没有任何缩进和换行，导致我在浏览器开发者工具中调试时非常痛苦。每次都需要手动格式化，或者复制到外部工具中处理，效率低下且容易出错。我尝试过一些php内置的HTML格式化方法，但它们的问题在于会“修正”HTML，而不是仅仅“美化”，这与我需要查看原始输出以定位问题的初衷相悖。正当我为此感到头疼时，我发现了gajus/dindent这个composer库，它完美地解决了我的困扰。
gajus/dindent是一个专门用于HTML缩进的PHP库，它的核心理念是：只负责缩进，不触碰你的HTML结构。这意味着，无论你的HTML是否完全符合规范，dindent都会忠实地为你添加缩进，让你能清晰地看到模板引擎究竟生成了什么，这对于调试来说至关重要。它不会像domDocument或Tidy那样尝试修复或删除不合法的HTML标签，而是保留原始的、甚至是“错误”的结构，仅仅通过美化排版来提升可读性。
如何使用 gajus/dindent 解决问题
使用gajus/dindent非常简单，首先通过Composer将其安装到你的项目中：
composer require gajus/dindent
安装完成后，你就可以在PHP代码中轻松地使用它来格式化HTML字符串了。下面是一个简单的示例：
<?php require 'vendor/autoload.php'; // 引入Composer自动加载文件 use GajusDindentIndenter; $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><table><tr><td>Cell 1</td><td>Cell 2</td></tr></table></div></body></html>'; echo "<!-- 格式化前 -->n"; echo $uglyHtml; echo "nn<!-- 格式化后 -->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> */
从上面的示例可以看出，原本挤成一团的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开发工具箱中的一把利器。
