在开发命令行工具或者需要在终端输出结构化数据时，我们经常会遇到一个问题：如何将数组清晰、美观地展示出来？手动编写格式化代码既繁琐又容易出错，尤其是在数组结构复杂或者需要频繁调整格式的时候。我最近就遇到了这样的问题，需要将从数据库查询出来的数据以表格的形式展示在终端上，以便用户快速浏览。
一开始，我尝试使用 printf 和手动计算列宽来实现，但很快就发现这种方法非常笨拙，代码可读性差，而且一旦数据结构发生变化，就需要重新调整格式化代码。于是，我开始寻找更优雅的解决方案，最终发现了 mathieuviossat/arraytotexttable 这个 composer 包。
mathieuviossat/arraytotexttable 是一个轻量级的 php 库，它可以将数组数据转换成易于阅读的文本表格，非常适合在终端或者命令行界面展示数据。它的安装和使用非常简单：
- 安装：
composer require mathieuviossat/arraytotexttable
- 使用：
use MathieuViossatUtilArrayToTextTable; $data = [ [ 'firstname' => 'Mollie', 'surname' => 'Alvarez', 'email' => 'molliealvarez@example.com', ], [ 'firstname' => 'Dianna', 'surname' => 'Mcbride', 'age' => 43, 'email' => 'diannamcbride@example.com', ], ]; $renderer = new ArrayToTextTable($data); echo $renderer->getTable();
只需要几行代码，就可以将数组数据转换成如下格式的表格：
┌───────────┬─────────┬───────────────────────────┬─────┐ │ FIRSTNAME │ SURNAME │ EMAIL │ AGE │ ├───────────┼─────────┼───────────────────────────┼─────┤ │ Mollie │ Alvarez │ molliealvarez@example.com │ │ │ Dianna │ Mcbride │ diannamcbride@example.com │ 43 │ └───────────┴─────────┴───────────────────────────┴─────┘
mathieuviossat/arraytotexttable 还提供了丰富的选项，可以自定义表格的样式和行为，例如：
- 设置装饰器： 可以选择不同的表格边框样式，包括 Unicode、ASCII 和 Blank。
- 设置缩进： 可以自定义表格的缩进字符。
- 显示/隐藏键名： 可以控制是否显示数组的键名。
- 设置键名/值的对齐方式： 可以设置键名和值的对齐方式，包括左对齐、居中对齐和右对齐。
- 设置格式化函数： 可以自定义格式化函数，对表格中的数据进行处理。
通过使用 mathieuviossat/arraytotexttable，我彻底告别了手动格式化数组数据的烦恼，代码变得更加简洁、易读，同时也提高了开发效率。如果你也需要在终端或者命令行界面展示数组数据，不妨尝试一下这个库，相信它会给你带来惊喜。
总结一下，mathieuviossat/arraytotexttable 的优势在于：
- 简单易用： 几行代码即可将数组转换为表格。
- 灵活定制： 提供了丰富的选项，可以自定义表格的样式和行为。
- 提高效率： 避免了手动格式化数据的繁琐工作。
- 可读性强： 生成的表格清晰、美观，易于阅读。
在实际应用中，mathieuviossat/arraytotexttable 可以用于：
- 命令行工具开发： 将程序的输出结果以表格的形式展示给用户。
- 调试： 在终端打印数组数据，方便调试。
- 日志记录： 将关键数据以表格的形式记录到日志文件中。
总而言之，mathieuviossat/arraytotexttable 是一个非常实用的 PHP 库，它可以帮助我们快速、高效地将数组数据展示在终端上，提高开发效率和用户体验。
