在開發命令行工具或者需要在終端輸出結構化數據時，我們經常會遇到一個問題：如何將數組清晰、美觀地展示出來？手動編寫格式化代碼既繁瑣又容易出錯，尤其是在數組結構復雜或者需要頻繁調整格式的時候。我最近就遇到了這樣的問題，需要將從數據庫查詢出來的數據以表格的形式展示在終端上，以便用戶快速瀏覽。
一開始，我嘗試使用 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 庫，它可以幫助我們快速、高效地將數組數據展示在終端上，提高開發效率和用戶體驗。
