PHPackages                             phplucidframe/console-table - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [CLI & Console](/categories/cli)
4. /
5. phplucidframe/console-table

ActiveLibrary[CLI & Console](/categories/cli)

phplucidframe/console-table
===========================

Console Table

v1.4.0(1y ago)102700.5k↓46.8%25[2 issues](https://github.com/phplucidframe/console-table/issues)20MITPHPPHP >=7.1CI failing

Since Sep 22Pushed 1y ago3 watchersCompare

[ Source](https://github.com/phplucidframe/console-table)[ Packagist](https://packagist.org/packages/phplucidframe/console-table)[ RSS](/packages/phplucidframe-console-table/feed)WikiDiscussions master Synced 2d ago

READMEChangelog (10)Dependencies (1)Versions (12)Used By (20)

PHP ConsoleTable
================

[](#php-consoletable)

**ConsoleTabe** makes you easy to build console style tables. It helps you to display tabular data in terminal/shell. This is a component of [PHPLucidFrame](https://github.com/phplucidframe/phplucidframe).

License: [MIT](https://opensource.org/licenses/MIT)

Composer Installation
---------------------

[](#composer-installation)

```
composer require phplucidframe/console-table

```

Example 1: Bordered Table (Default)
-----------------------------------

[](#example-1-bordered-table-default)

```
$table = new LucidFrame\Console\ConsoleTable();
$table
    ->addHeader('Language')
    ->addHeader('Year')
    ->addRow()
        ->addColumn('PHP')
        ->addColumn(1994)
    ->addRow()
        ->addColumn('C++')
        ->addColumn(1983)
    ->addRow()
        ->addColumn('C')
        ->addColumn(1970)
    ->display()
;

```

You can also print the table using `getTable` method such as `echo $table->getTable();`

**Output**:

```
+----------+------+
| Language | Year |
+----------+------+
| PHP      | 1994 |
| C++      | 1983 |
| C        | 1970 |
+----------+------+

```

Example 2: Bordered Table with Padding Width 2
----------------------------------------------

[](#example-2-bordered-table-with-padding-width-2)

You can also use `setHeaders()` and `addRow` with Arrays.

```
$table = new LucidFrame\Console\ConsoleTable();
$table
    ->setHeaders(array('Language', 'Year'))
    ->addRow(array('PHP', 1994))
    ->addRow(array('C++', 1983))
    ->addRow(array('C', 1970))
    ->setPadding(2)
    ->display()
;

```

**Output**:

```
+------------+--------+
|  Language  |  Year  |
+------------+--------+
|  PHP       |  1994  |
|  C++       |  1983  |
|  C         |  1970  |
+------------+--------+

```

Example 3: Bordered Table with Left Margin Width 4
--------------------------------------------------

[](#example-3-bordered-table-with-left-margin-width-4)

```
$table = new LucidFrame\Console\ConsoleTable();
$table
    ->setHeaders(array('Language', 'Year'))
    ->addRow(array('PHP', 1994))
    ->addRow(array('C++', 1983))
    ->addRow(array('C', 1970))
    ->setIndent(4)
    ->display()
;

```

**Output**:

```
    +----------+------+
    | Language | Year |
    +----------+------+
    | PHP      | 1994 |
    | C++      | 1983 |
    | C        | 1970 |
    +----------+------+

```

Example 4: Non-bordered Table with Header
-----------------------------------------

[](#example-4-non-bordered-table-with-header)

```
$table = new LucidFrame\Console\ConsoleTable();
$table
    ->setHeaders(array('Language', 'Year'))
    ->addRow(array('PHP', 1994))
    ->addRow(array('C++', 1983))
    ->addRow(array('C', 1970))
    ->hideBorder()
    ->display()
;

```

**Output**:

```
 Language  Year
----------------
 PHP       1994
 C++       1983
 C         1970

```

Example 5: Non-bordered Table without Header
--------------------------------------------

[](#example-5-non-bordered-table-without-header)

```
$table = new LucidFrame\Console\ConsoleTable();
$table
    ->addRow(array('PHP', 1994))
    ->addRow(array('C++', 1983))
    ->addRow(array('C', 1970))
    ->hideBorder()
    ->display()
;

```

**Output**:

```
 PHP  1994
 C++  1983
 C    1970

```

Example 6: Table with all borders
---------------------------------

[](#example-6-table-with-all-borders)

```
$table = new LucidFrame\Console\ConsoleTable();
$table
    ->setHeaders(array('Language', 'Year'))
    ->addRow(array('PHP', 1994))
    ->addRow(array('C++', 1983))
    ->addRow(array('C', 1970))
    ->showAllBorders()
    ->display()
;

```

Alternatively, you can use `addBorderLine()` for each row.

```
$table
    ->setHeaders(array('Language', 'Year'))
    ->addRow(array('PHP', 1994))
    ->addBorderLine()
    ->addRow(array('C++', 1983))
    ->addBorderLine()
    ->addRow(array('C', 1970))
    ->display()
;

```

**Output**

```
+----------+------+
| Language | Year |
+----------+------+
| PHP      | 1994 |
+----------+------+
| C++      | 1983 |
+----------+------+
| C        | 1970 |
+----------+------+

```

Example 7: Table with Column Alignment
--------------------------------------

[](#example-7-table-with-column-alignment)

```
$table = new LucidFrame\Console\ConsoleTable();
$table
    ->addHeader('A')
    ->addHeader('B', ConsoleTable::ALIGN_RIGHT) # ALIGN_LEFT or ALIGN_RIGHT (ALIGN_LEFT is default)
    ->addHeader('C')
    ->addRow()
        ->addColumn('X')
        ->addColumn('Hello', null, null, ConsoleTable::ALIGN_RIGHT)
        ->addColumn('Nice')
    ->addRow()
        ->addColumn('Y')
        ->addColumn('Hello, how are you?')
        ->addColumn('OK', null, null, ConsoleTable::ALIGN_RIGHT)
    ->display();

```

**Output**

```
+---+---------------------+------+
| A |                   B | C    |
+---+---------------------+------+
| X |               Hello | Nice |
| Y | Hello, how are you? |   OK |
+---+---------------------+------+

```

Example 8: Bordered Table with Header & Footer
==================================================

[](#example-8-bordered-table-with-header--footer)

```
$table = new LucidFrame\Console\ConsoleTable();
$table
    ->addHeader('Name')
    ->addHeader('Age')
    ->addRow()
        ->addColumn('John')
        ->addColumn(25, null, null, ConsoleTable::ALIGN_RIGHT)
    ->addRow()
        ->addColumn('Jane')
        ->addColumn(23, null, null, ConsoleTable::ALIGN_RIGHT)
    ->addFooter('Total')
    ->addFooter('48', ConsoleTable::ALIGN_RIGHT)
    ->display();

```

**Output**

```
+-------+-----+
| Name  | Age |
+-------+-----+
| John  |  25 |
| Jane  |  23 |
+-------+-----+
| Total |  48 |
+-------+-----+

```

Example 9: Non-bordered Table with Header & Footer
======================================================

[](#example-9-non-bordered-table-with-header--footer)

```
$table = new LucidFrame\Console\ConsoleTable();
$table
    ->setHeaders(array('Name', 'Age'))
    ->addRow(array('John', 25))
    ->addRow(array('Jane', 23))
    ->setFooters(array('Total', 48))
    ->hideBorder()
    ->display();

```

**Output**

```
Name   Age
-----------
John   25
Jane   23
-----------
Total  48

```

Test
----

[](#test)

With PHPUnit, you can run this in your terminal.

```
composer install
vendor\bin\phpunit tests

```

Without PHPUnit, you can simply run this in your terminal.

```
php example.php

```

###  Health Score

52

—

FairBetter than 96% of packages

Maintenance46

Moderate activity, may be stable

Popularity54

Moderate usage in the ecosystem

Community30

Small or concentrated contributor base

Maturity65

Established project with proven stability

 Bus Factor1

Top contributor holds 78.9% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~352 days

Recently: every ~597 days

Total

10

Last Release

402d ago

PHP version history (2 changes)v1.0.0PHP >=5.3

v1.3.1PHP >=7.1

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/4285555?v=4)[Sithu](/maintainers/cithukyaw)[@cithukyaw](https://github.com/cithukyaw)

---

Top Contributors

[![cithukyaw](https://avatars.githubusercontent.com/u/4285555?v=4)](https://github.com/cithukyaw "cithukyaw (30 commits)")[![pitsolu](https://avatars.githubusercontent.com/u/16669704?v=4)](https://github.com/pitsolu "pitsolu (4 commits)")[![matteoporru](https://avatars.githubusercontent.com/u/34092391?v=4)](https://github.com/matteoporru "matteoporru (2 commits)")[![dblencowe](https://avatars.githubusercontent.com/u/88084?v=4)](https://github.com/dblencowe "dblencowe (1 commits)")[![i-amdroid](https://avatars.githubusercontent.com/u/4057077?v=4)](https://github.com/i-amdroid "i-amdroid (1 commits)")

---

Tags

console-toolphpphp-frameworkphp-libraryphplucidframe

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/phplucidframe-console-table/health.svg)

```
[![Health](https://phpackages.com/badges/phplucidframe-console-table/health.svg)](https://phpackages.com/packages/phplucidframe-console-table)
```

###  Alternatives

[illuminate/console

The Illuminate Console package.

13046.0M6.5k](/packages/illuminate-console)[styleci/cli

The CLI tool for StyleCI

71470.5k9](/packages/styleci-cli)[winbox/args

Windows command-line formatter

20720.9k21](/packages/winbox-args)[tomatophp/filament-artisan

Simple but yet powerful library for running some artisan commands for FilamentPHP

3275.4k1](/packages/tomatophp-filament-artisan)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)