dekor / php-array-table
PHP Library for printing associative arrays as text table (similar to mysql terminal console)
Installs: 1 663 456
Dependents: 1
Suggesters: 0
Security: 0
Stars: 24
Watchers: 3
Forks: 5
Open Issues: 2
Requires
- php: >=5.6.0
- ext-mbstring: *
Requires (Dev)
- phpunit/phpunit: ^10
This package is auto-updated.
Last update: 2024-10-19 13:06:01 UTC
README
PHP-class, which allows to transform php associative arrays to cool ASCII tables.
Quick doc:
https://deniskoronets.github.io/php-array-table/
Installation
Simply run composer require:
composer require dekor/php-array-table
or add to composer.json:
"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:
+----+-----------------+----------------+ | 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.
You're able to develop your own formatters by extending BaseColumnFormatter
and implementing abstract methods.
List of formatters out of the box:
AlignFormatter
- allows to set text align for inner column (useful for numbers):
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:
+------+------------------------------------------+-------+ | 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:
+-------+-------+ | 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:
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