dekor/php-array-table

PHP Library for printing associative arrays as text table (similar to mysql terminal console)

PHP Array To Text Table

, _(*1)

PHP-class, which allows to transform php associative arrays to cool ASCII tables., _(*2)

Ukraine ❤, _(*3)

Quick doc:

https://deniskoronets.github.io/php-array-table/, _(*4)

Installation

Simply run composer require:, _(*5)

composer require dekor/php-array-table

or add to composer.json:, _(*6)

"dekor/php-array-table": "^2.0"

Usage

use dekor\ArrayToTextTable;

$data = [
    [
        'id' => 1,
        'name' => 'Denis Koronets',
        'role' => 'php developer',
    ],
    [
        'id' => 2,
        'name' => 'Maxim Ambroskin',
        'role' => 'java developer',
    ],
    [
        'id' => 3,
        'name' => 'Andrew Sikorsky',
        'role' => 'php developer',
    ]
];

echo (new ArrayToTextTable($data))->render();

Will draw the next output:, _(*7)

+----+-----------------+----------------+
| id | name            | role           |
+----+-----------------+----------------+
| 1  | Denis Koronets  | php developer  |
| 2  | Maxim Ambroskin | java developer |
| 3  | Andrew Sikorsky | php developer  |
+----+-----------------+----------------+

Formatters (since v2)

Version 2 introduces a new feature that allows to pre and postprocess column data by applying filters., _(*8)

You're able to develop your own formatters by extending BaseColumnFormatter and implementing abstract methods., _(*9)

List of formatters out of the box: - AlignFormatter - allows to set text align for inner column (useful for numbers):, _(*10)

use dekor\ArrayToTextTable;
use dekor\formatters\AlignFormatter;

$data = [
    [
        'left' => 2,
        'center' => 'Dummy one',
        'right' => 14.33,
    ],
    [
        'left' => 3,
        'center' => 'Another great day for a great inventers!',
        'right' => 1,
    ],
];

$builder = new ArrayToTextTable($data);
$builder->applyFormatter(new AlignFormatter(['center' => 'center', 'right' => 'right']));

echo $builder->render();

outputs:, _(*11)

+------+------------------------------------------+-------+
| left | center                                   | right |
+------+------------------------------------------+-------+
| 2    |                Dummy one                 | 14.33 |
| 3    | Another great day for a great inventers! |     1 |
+------+------------------------------------------+-------+

• SprintfFormatter - allows to format column value before rendering using sprintf function (ex: %01.3f)

use dekor\ArrayToTextTable;
use dekor\formatters\SprintfFormatter;

$data = [
    [
        'left' => 1,
        'right' => 2.89,
    ]
];

$builder = new ArrayToTextTable($data);
$builder->applyFormatter(new SprintfFormatter(['left' => '%01.3f', 'right' => '%03.3f']));

echo $builder->render();

outputs:, _(*12)

+-------+-------+
| left  | right |
+-------+-------+
| 1.000 | 2.890 |
+-------+-------+

• ColorFormatter - allows to highlight text with specific color (only works in terminal):

use dekor\ArrayToTextTable;
use dekor\formatters\ColorFormatter;

$data = [
    ['test' => 1],
    ['test' => -1],
];

$builder = new ArrayToTextTable($data);
$builder->applyFormatter(new ColorFormatter(['test' => fn ($value) => $value > 0 ? 'Red' : 'Green']));

echo $builder->render() . PHP_EOL;

outputs:, _(*13)

, _(*14)

Allowed colors list (see ColorFormatter::$colors) - Black - Dark Grey - Red - Light Red - Green - Light Green - Brown - Yellow - Blue - Light Blue - Magenta - Light Magenta - Cyan - Light Cyan - Light Grey - White, _(*15)

Our sponsors list:

, _(*16)