PHPackages                             serendipity\_hq/php\_text\_matrix - 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. [Utility &amp; Helpers](/categories/utility)
4. /
5. serendipity\_hq/php\_text\_matrix

Abandoned → [serendipity\_hq/component-text-matrix](/?search=serendipity_hq%2Fcomponent-text-matrix)Library[Utility &amp; Helpers](/categories/utility)

serendipity\_hq/php\_text\_matrix
=================================

A PHP library to render an array representing a matrix as a plain text table.

3.0.6(1y ago)51.8k1MITPHPPHP ^7.4|^8.0CI passing

Since Sep 24Pushed 2mo ago1 watchersCompare

[ Source](https://github.com/Aerendir/component-text-matrix)[ Packagist](https://packagist.org/packages/serendipity_hq/php_text_matrix)[ Docs](https://github.com/Aerendir/component-text-matrix)[ RSS](/packages/serendipity-hq-php-text-matrix/feed)WikiDiscussions dev Synced 1mo ago

READMEChangelogDependencies (10)Versions (26)Used By (0)

 [ ![](https://camo.githubusercontent.com/5041251627a7ec1bf9335a20531d818d198f5315fc6e12d88c4694c9dcfd5bc7/687474703a2f2f7777772e736572656e64697069747968712e636f6d2f6173736574732f6f70656e2d736f757263652d70726f6a656374732f4c6f676f2d536572656e64697069747948512d49636f6e2d546578742d507572706c652e706e67) ](http://www.serendipityhq.com)

Serendipity HQ Text Matrix
==========================

[](#serendipity-hq-text-matrix)

Renders into a plain text table an array representing a matrix of data.

 [![](https://camo.githubusercontent.com/bc2c24dee3816ad2cc56c6c4f6157f20bf559a61c4b1a3df824cb3da5731412b/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f736572656e6469706974795f68712f636f6d706f6e656e742d746578742d6d61747269782e7376673f7374796c653d666c61742d737175617265)](https://github.com/Aerendir/component-text-matrix/releases) [![](https://camo.githubusercontent.com/55c0218c8f8009f06ad4ddae837ddd05301481fcf0dff8e0ed9dadda8780713e/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d627269676874677265656e2e7376673f7374796c653d666c61742d737175617265)](https://opensource.org/licenses/MIT) [![](https://camo.githubusercontent.com/4dc2ed25e8e289efa92624215fa8fd6f9827097ff61b9adf3a8227acd7fa969b/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f7068702d762f736572656e6469706974795f68712f636f6d706f6e656e742d746578742d6d61747269783f636f6c6f723d253233383839324246267374796c653d666c61742d737175617265266c6f676f3d706870)](https://github.com/Aerendir/component-text-matrix/releases)

 Supports
 [![](https://camo.githubusercontent.com/152f8cb6191d2308b19e8962cbcefc2cf04a6606af6f40163c7ef74ba4499c63/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f53796d666f6e792d253545342e342d3333333f7374796c653d666c61742d737175617265266c6f676f3d73796d666f6e79 "Supports Symfony ^4.4")](https://github.com/Aerendir/component-text-matrix/actions "Supports Symfony ^4.4") [![](https://camo.githubusercontent.com/eb005363bda440d1e5a2ba01ee729aac6471c5927ee5b89a9289ce09ab53fae8/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f53796d666f6e792d253545352e342d3333333f7374796c653d666c61742d737175617265266c6f676f3d73796d666f6e79 "Supports Symfony ^5.4")](https://github.com/Aerendir/component-text-matrix/actions "Supports Symfony ^5.4") [![](https://camo.githubusercontent.com/5ff3e72a5cdb413dcb81412c452389b639e7797910635cfebb8104c1e696809c/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f53796d666f6e792d253545362e302d3333333f7374796c653d666c61742d737175617265266c6f676f3d73796d666f6e79 "Supports Symfony ^6.0")](https://github.com/Aerendir/component-text-matrix/actions "Supports Symfony ^6.0")

 Tested on
 [![](https://camo.githubusercontent.com/152f8cb6191d2308b19e8962cbcefc2cf04a6606af6f40163c7ef74ba4499c63/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f53796d666f6e792d253545342e342d3333333f7374796c653d666c61742d737175617265266c6f676f3d73796d666f6e79 "Tested with Symfony ^4.4")](https://github.com/Aerendir/component-text-matrix/actions "Tested with Symfony ^4.4") [![](https://camo.githubusercontent.com/eb005363bda440d1e5a2ba01ee729aac6471c5927ee5b89a9289ce09ab53fae8/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f53796d666f6e792d253545352e342d3333333f7374796c653d666c61742d737175617265266c6f676f3d73796d666f6e79 "Tested with Symfony ^5.4")](https://github.com/Aerendir/component-text-matrix/actions "Tested with Symfony ^5.4") [![](https://camo.githubusercontent.com/5ff3e72a5cdb413dcb81412c452389b639e7797910635cfebb8104c1e696809c/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f53796d666f6e792d253545362e302d3333333f7374796c653d666c61742d737175617265266c6f676f3d73796d666f6e79 "Tested with Symfony ^6.0")](https://github.com/Aerendir/component-text-matrix/actions "Tested with Symfony ^6.0")

 [![](https://camo.githubusercontent.com/232fa85d176d629f494d129b1ba104da2b8c2aba833f0feb38d7a19ec4a38114/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f52657175697265732d6578742d2d69636f6e762d2532333838393242463f7374796c653d666c61742d737175617265266c6f676f3d706870)](https://www.php.net/manual/en/book.iconv.php)

Current Status
--------------

[](#current-status)

[![Coverage](https://camo.githubusercontent.com/db28ebbf60e4f645eda1e87fba812c04c472aa9ac5a3e6c5114ebb77f005046f/68747470733a2f2f736f6e6172636c6f75642e696f2f6170692f70726f6a6563745f6261646765732f6d6561737572653f70726f6a6563743d416572656e6469725f636f6d706f6e656e742d746578742d6d6174726978266d65747269633d636f766572616765)](https://sonarcloud.io/dashboard?id=Aerendir_component-text-matrix)[![Maintainability Rating](https://camo.githubusercontent.com/66805dff13c7252ffb9f637f267030cd62575eb505d7e97cd19fbbda36bcf9e9/68747470733a2f2f736f6e6172636c6f75642e696f2f6170692f70726f6a6563745f6261646765732f6d6561737572653f70726f6a6563743d416572656e6469725f636f6d706f6e656e742d746578742d6d6174726978266d65747269633d7371616c655f726174696e67)](https://sonarcloud.io/dashboard?id=Aerendir_component-text-matrix)[![Quality Gate Status](https://camo.githubusercontent.com/6f7f08f356389edffefc819ddb5ca1534de90f6cf4ea4a33497c5bd74c76ae95/68747470733a2f2f736f6e6172636c6f75642e696f2f6170692f70726f6a6563745f6261646765732f6d6561737572653f70726f6a6563743d416572656e6469725f636f6d706f6e656e742d746578742d6d6174726978266d65747269633d616c6572745f737461747573)](https://sonarcloud.io/dashboard?id=Aerendir_component-text-matrix)[![Reliability Rating](https://camo.githubusercontent.com/f6ff8361b92771b700e32688f312b76dda0618991d9e136d1db2c75c989bab85/68747470733a2f2f736f6e6172636c6f75642e696f2f6170692f70726f6a6563745f6261646765732f6d6561737572653f70726f6a6563743d416572656e6469725f636f6d706f6e656e742d746578742d6d6174726978266d65747269633d72656c696162696c6974795f726174696e67)](https://sonarcloud.io/dashboard?id=Aerendir_component-text-matrix)[![Security Rating](https://camo.githubusercontent.com/8dab39361ee07dc549e28c2b01afc90a0ff3ab90445c97bd3c1c750755814edc/68747470733a2f2f736f6e6172636c6f75642e696f2f6170692f70726f6a6563745f6261646765732f6d6561737572653f70726f6a6563743d416572656e6469725f636f6d706f6e656e742d746578742d6d6174726978266d65747269633d73656375726974795f726174696e67)](https://sonarcloud.io/dashboard?id=Aerendir_component-text-matrix)[![Technical Debt](https://camo.githubusercontent.com/e6340ad53ac810e7df017ed298be3b815cdb2554ee46fe598854e6ea5fff86fb/68747470733a2f2f736f6e6172636c6f75642e696f2f6170692f70726f6a6563745f6261646765732f6d6561737572653f70726f6a6563743d416572656e6469725f636f6d706f6e656e742d746578742d6d6174726978266d65747269633d7371616c655f696e646578)](https://sonarcloud.io/dashboard?id=Aerendir_component-text-matrix)[![Vulnerabilities](https://camo.githubusercontent.com/b0eda829fd29d160467dee12dc7d2b949351200a1a3565ee188d79801dc2d561/68747470733a2f2f736f6e6172636c6f75642e696f2f6170692f70726f6a6563745f6261646765732f6d6561737572653f70726f6a6563743d416572656e6469725f636f6d706f6e656e742d746578742d6d6174726978266d65747269633d76756c6e65726162696c6974696573)](https://sonarcloud.io/dashboard?id=Aerendir_component-text-matrix)

[![Phan](https://github.com/Aerendir/component-text-matrix/workflows/Phan/badge.svg)](https://github.com/Aerendir/component-text-matrix/workflows/Phan/badge.svg)[![PHPStan](https://github.com/Aerendir/component-text-matrix/workflows/PHPStan/badge.svg)](https://github.com/Aerendir/component-text-matrix/workflows/PHPStan/badge.svg)[![PSalm](https://github.com/Aerendir/component-text-matrix/workflows/PSalm/badge.svg)](https://github.com/Aerendir/component-text-matrix/workflows/PSalm/badge.svg)[![PHPUnit](https://github.com/Aerendir/component-text-matrix/workflows/PHPunit/badge.svg)](https://github.com/Aerendir/component-text-matrix/workflows/PHPunit/badge.svg)[![Composer](https://github.com/Aerendir/component-text-matrix/workflows/Composer/badge.svg)](https://github.com/Aerendir/component-text-matrix/workflows/Composer/badge.svg)[![PHP CS Fixer](https://github.com/Aerendir/component-text-matrix/workflows/PHP%20CS%20Fixer/badge.svg)](https://github.com/Aerendir/component-text-matrix/workflows/PHP%20CS%20Fixer/badge.svg)[![Rector](https://github.com/Aerendir/component-text-matrix/workflows/Rector/badge.svg)](https://github.com/Aerendir/component-text-matrix/workflows/Rector/badge.svg)

Features
--------

[](#features)

- Four direction padding (top, right, bottom and left) on a per column basis (following the CSS syntax);
- Max columns width, with possibility to cut words or to maintain their integrity (as the word-wrap CSS property);
- Left and right alignement on a per column basis;
- Customizable vertical, horizontal and cross separators, both for header and for content;
- Different default style for the header (the first row passed);
- Ability to remove the first line divider for the header;

---

###  **Do you like this library?**
 **[LEAVE A ★](#js-repo-pjax-container)**

[](#----do-you-like-this-library----leave-a-)

 or run
 `composer global require symfony/thanks && composer thanks`
 to say thank you to all libraries you use in your current project, this included!

---

Install Serendipity HQ Text Matrix via Composer
-----------------------------------------------

[](#install-serendipity-hq-text-matrix-via-composer)

```
$ composer require serendipity_hq/component-text-matrix

```

This library follows the  versioning conventions.

How to use Serendipity HQ Text Matrix
-------------------------------------

[](#how-to-use-serendipity-hq-text-matrix)

component-text-matrix allows a great flexibility in rendering data as plain text tables. You can customize a lot of aspctes of your generated table.

If some feature is missed, you can open an issue and integrate it and submit a pull request. Remeber to test you new feature: not tested features will not be merged.

### Basic usage

[](#basic-usage)

To use component-text-matrix you need only an array representing a matrix:

```
// The array containing the data
$data = [
    [
        'title' => '20.000 Leghe sotto i mari',
        'author' => 'Jules Verne',
        'review' => 'Una misteriosa creatura marina che affonda navi da guerra di ogni paese, la scoperta di uno straordinario mezzo meccanico - il sommergibile Nautilus capace di esplorare le profondità degli abissi marini, il suo comandante, il Capitano Nemo, un uomo nobile e generoso che cela però nell\'animo un insopprimibile desiderio di odio e di vendetta, il professor Arronax, il suo servitore Consiglio e il fiociniere Ned Land. E poi le meraviglie di un continente sconosciuto - l\'oceano e i suoi abissi - le esplorazioni attraverso tutti i mari, le lotte contro mostri spaventosi, la fede in una scienza che dovrebbe offrire all\'uomo un progresso inarrestabile, il desiderio di libertà che anima tutti i personaggi del libro.'
    ],
    [
        'title' => 'Il signore degli anelli:        La compagnia dell\'anello',
        'author' => 'J. R. R. Tolkien',
        'review' => 'In questo primo romanzo della trilogia di Tolkien, il lettore conosce gli Hobbit, minuscoli esseri saggi e longevi. Frodo, venuto in possesso dell\'Anello del Potere, è costretto a partire per il paese delle tenebre. Un gruppo di Hobbit lo accompagna e, strada facendo, si associano alla compagnia altri esseri: Elfi, Nani e Uomini, anch\'essi legati al destino di Frodo. Le tappe del cammino li conducono attraverso molte esperienze diverse, finché la scomparsa di Gandalf, trascinato negli abissi da un\'orrenda creatura, li lascia senza guida. Così si scioglie la Compagnia dell\'Anello e i suoi membri si disperdono, minacciati da forze tenebrose, mentre la meta sembra disperatamente allontanarsi.'
    ],
    [
        'title' => 'Il leviatano',
        'author' => 'T. Hobbes contraddittorietà',
        'review' => 'Vitale rappresentazione dello Stato moderno, longeva e barocca figura di pensiero politico nelle sembianze di un mostro biblico, il "Leviatano" è certamente l\'opera filosofica più dibattuta degli ultimi quattro secoli: vi sono contenute le radici del moderno Stato di diritto e di esperienze politiche antiassolutistiche come la Rivoluzione francese, elementi necessari a comprendere le vicende più recenti delle democrazie europee. Pubblicato per la prima volta nel 1651, al termine di un\'epoca che aveva visto l\'Europa dilaniata da guerre civili e di religione, il "Leviatano" definisce tutte le logiche e le categorie della modernità, inclusa la loro duplicità e contraddittorietà. Perché reca in sé non solo un\'architettura di istituzioni, ma anche un campo di conflitti, non solo la stabilità, ma anche la possibilità del fallimento. Superare la forma Stato descritta in queste pagine resta una delle grandi sfide del XXI secolo.'
    ]
];

$table = new \SerendipityHQ\Component\component-text-matrix\component-text-matrix($data);

echo '';
echo $table->render();
echo '';

```

This will render a table like this:

```
+-------------------------------------------------+---------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|20.000 Leghe sotto i mari                        |Jules Verne                |Una misteriosa creatura marina che affonda navi da guerra di ogni paese, la scoperta di uno straordinario mezzo meccanico - il sommergibile Nautilus capace di esplorare le profondità degli abissi marini, il suo comandante, il Capitano Nemo, un uomo nobile e generoso che cela però nell'animo un insopprimibile desiderio di odio e di vendetta, il professor Arronax, il suo servitore Consiglio e il fiociniere Ned Land. E poi le meraviglie di un continente sconosciuto - l'oceano e i suoi abissi - le esplorazioni attraverso tutti i mari, le lotte contro mostri spaventosi, la fede in una scienza che dovrebbe offrire all'uomo un progresso inarrestabile, il desiderio di libertà che anima tutti i personaggi del libro.                                                                                                                                                                                                                          |
+-------------------------------------------------+---------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|Il signore degli anelli: La compagnia dell'anello|J. R. R. Tolkien           |In questo primo romanzo della trilogia di Tolkien, il lettore conosce gli Hobbit, minuscoli esseri saggi e longevi. Frodo, venuto in possesso dell'Anello del Potere, è costretto a partire per il paese delle tenebre. Un gruppo di Hobbit lo accompagna e, strada facendo, si associano alla compagnia altri esseri: Elfi, Nani e Uomini, anch'essi legati al destino di Frodo. Le tappe del cammino li conducono attraverso molte esperienze diverse, finché la scomparsa di Gandalf, trascinato negli abissi da un'orrenda creatura, li lascia senza guida. Così si scioglie la Compagnia dell'Anello e i suoi membri si disperdono, minacciati da forze tenebrose, mentre la meta sembra disperatamente allontanarsi.                                                                                                                                                                                                                                            |
+-------------------------------------------------+---------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|Il leviatano                                     |T. Hobbes contraddittorietà|Vitale rappresentazione dello Stato moderno, longeva e barocca figura di pensiero politico nelle sembianze di un mostro biblico, il "Leviatano" è certamente l'opera filosofica più dibattuta degli ultimi quattro secoli: vi sono contenute le radici del moderno Stato di diritto e di esperienze politiche antiassolutistiche come la Rivoluzione francese, elementi necessari a comprendere le vicende più recenti delle democrazie europee. Pubblicato per la prima volta nel 1651, al termine di un'epoca che aveva visto l'Europa dilaniata da guerre civili e di religione, il "Leviatano" definisce tutte le logiche e le categorie della modernità, inclusa la loro duplicità e contraddittorietà. Perché reca in sé non solo un'architettura di istituzioni, ma anche un campo di conflitti, non solo la stabilità, ma anche la possibilità del fallimento. Superare la forma Stato descritta in queste pagine resta una delle grandi sfide del XXI secolo.|
+-------------------------------------------------+---------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+

```

### Padding, columns max width and word wrapping

[](#padding-columns-max-width-and-word-wrapping)

Passing some options to the `render()` method it is possible to customize your plain text table:

```
$options = [
    'columns' => [
        'review' => [
            'max_width' => 50
        ],
        'title' => [
            'max_width' => 20,
            // Equal to CSS word-break: break-all
            'cut' => true
        ]
    ],
    'cells_padding' => 5
];

$table = new \SerendipityHQ\Component\component-text-matrix\component-text-matrix($data);

echo '';
echo $table->render($options);
echo '';

```

This will generate the following table:

```
+------------------------------+-------------------------------------+------------------------------------------------------------+
|                              |                                     |                                                            |
|                              |                                     |                                                            |
|                              |                                     |                                                            |
|                              |                                     |                                                            |
|                              |                                     |                                                            |
|     20.000 Leghe sotto i     |     Jules Verne                     |     Una misteriosa creatura marina che affonda navi da     |
|     mari                     |                                     |     guerra di ogni paese, la scoperta di uno               |
|                              |                                     |     straordinario mezzo meccanico - il sommergibile        |
|                              |                                     |     Nautilus capace di esplorare le profondità degli       |
|                              |                                     |     abissi marini, il suo comandante, il Capitano          |
|                              |                                     |     Nemo, un uomo nobile e generoso che cela però          |
|                              |                                     |     nell'animo un insopprimibile desiderio di odio e       |
|                              |                                     |     di vendetta, il professor Arronax, il suo              |
|                              |                                     |     servitore Consiglio e il fiociniere Ned Land. E        |
|                              |                                     |     poi le meraviglie di un continente sconosciuto -       |
|                              |                                     |     l'oceano e i suoi abissi - le esplorazioni             |
|                              |                                     |     attraverso tutti i mari, le lotte contro mostri        |
|                              |                                     |     spaventosi, la fede in una scienza che dovrebbe        |
|                              |                                     |     offrire all'uomo un progresso inarrestabile, il        |
|                              |                                     |     desiderio di libertà che anima tutti i personaggi      |
|                              |                                     |     del libro.                                             |
|                              |                                     |                                                            |
|                              |                                     |                                                            |
|                              |                                     |                                                            |
|                              |                                     |                                                            |
|                              |                                     |                                                            |
+------------------------------+-------------------------------------+------------------------------------------------------------+
|                              |                                     |                                                            |
|                              |                                     |                                                            |
|                              |                                     |                                                            |
|                              |                                     |                                                            |
|                              |                                     |                                                            |
|     Il signore degli         |     J. R. R. Tolkien                |     In questo primo romanzo della trilogia di Tolkien,     |
|     anelli: La compagnia     |                                     |     il lettore conosce gli Hobbit, minuscoli esseri        |
|     dell'anello              |                                     |     saggi e longevi. Frodo, venuto in possesso             |
|                              |                                     |     dell'Anello del Potere, è costretto a partire per      |
|                              |                                     |     il paese delle tenebre. Un gruppo di Hobbit lo         |
|                              |                                     |     accompagna e, strada facendo, si associano alla        |
|                              |                                     |     compagnia altri esseri: Elfi, Nani e Uomini,           |
|                              |                                     |     anch'essi legati al destino di Frodo. Le tappe del     |
|                              |                                     |     cammino li conducono attraverso molte esperienze       |
|                              |                                     |     diverse, finché la scomparsa di Gandalf,               |
|                              |                                     |     trascinato negli abissi da un'orrenda creatura, li     |
|                              |                                     |     lascia senza guida. Così si scioglie la Compagnia      |
|                              |                                     |     dell'Anello e i suoi membri si disperdono,             |
|                              |                                     |     minacciati da forze tenebrose, mentre la meta          |
|                              |                                     |     sembra disperatamente allontanarsi.                    |
|                              |                                     |                                                            |
|                              |                                     |                                                            |
|                              |                                     |                                                            |
|                              |                                     |                                                            |
|                              |                                     |                                                            |
+------------------------------+-------------------------------------+------------------------------------------------------------+
|                              |                                     |                                                            |
|                              |                                     |                                                            |
|                              |                                     |                                                            |
|                              |                                     |                                                            |
|                              |                                     |                                                            |
|     Il leviatano             |     T. Hobbes contraddittorietà     |     Vitale rappresentazione dello Stato moderno,           |
|                              |                                     |     longeva e barocca figura di pensiero politico          |
|                              |                                     |     nelle sembianze di un mostro biblico, il               |
|                              |                                     |     "Leviatano" è certamente l'opera filosofica più        |
|                              |                                     |     dibattuta degli ultimi quattro secoli: vi sono         |
|                              |                                     |     contenute le radici del moderno Stato di diritto e     |
|                              |                                     |     di esperienze politiche antiassolutistiche come la     |
|                              |                                     |     Rivoluzione francese, elementi necessari a             |
|                              |                                     |     comprendere le vicende più recenti delle               |
|                              |                                     |     democrazie europee. Pubblicato per la prima volta      |
|                              |                                     |     nel 1651, al termine di un'epoca che aveva visto       |
|                              |                                     |     l'Europa dilaniata da guerre civili e di               |
|                              |                                     |     religione, il "Leviatano" definisce tutte le           |
|                              |                                     |     logiche e le categorie della modernità, inclusa        |
|                              |                                     |     la loro duplicità e contraddittorietà. Perché          |
|                              |                                     |     reca in sé non solo un'architettura di                 |
|                              |                                     |     istituzioni, ma anche un campo di conflitti, non       |
|                              |                                     |     solo la stabilità, ma anche la possibilità del         |
|                              |                                     |     fallimento. Superare la forma Stato descritta in       |
|                              |                                     |     queste pagine resta una delle grandi sfide del XXI     |
|                              |                                     |     secolo.                                                |
|                              |                                     |                                                            |
|                              |                                     |                                                            |
|                              |                                     |                                                            |
|                              |                                     |                                                            |
|                              |                                     |                                                            |
+------------------------------+-------------------------------------+------------------------------------------------------------+

```

### Customize Header and separators

[](#customize-header-and-separators)

```
$data = [
    [
        'quantity' => 'Quantity',
        'description' => 'Description',
        'price' => 'Price'
    ],
    [
        'quantity' => '1 month',
        'description' => 'TrustBack.Me:       Base plan' . PHP_EOL . 'From Sep 26 2016 to Oct 26 2016.',
        'price' => '$29.00'
    ],
    [
        'quantity' => '',
        'description' => 'Credit applied',
        'price' => '-$29.00'
    ]
];

// The array containing the data
$options = [
    'has_header' => true,
    'cells_padding' => [0, 3],
    'sep_head_v' => ' ',
    'sep_head_x' => ' ',
    'sep_head_h' => '-',
    'sep_v' => ' ',
    'sep_x' => ' ',
    'sep_h' => ' ',
    'show_head_top_sep' => false,
    'columns' => [
        'description' => [
            'max_width' => 40,
            // Equal to CSS word-break: break-all
            'cut' => true
        ],
        'price' => [
            'align' => 'right',
            'min_width' => 15
        ]
    ]
];

$table = new \SerendipityHQ\Component\component-text-matrix\component-text-matrix($data);

echo '';
echo $table->render($options);
echo '';

```

This is the generated table:

```
    Quantity       Description                                      Price
 -------------- -------------------------------------- ---------------------
    1 month        TrustBack.Me: Base plan                         $29.00
                   From Sep 26 2016 to Oct 26 2016.

                   Credit applied                                 -$29.00

```

### Final notes

[](#final-notes)

- Use the `cut` option setting it to tru or false to determine if the word can be broken or not (see the [`wordwrap` PHP function](http://php.net/manual/en/function.wordwrap.php))
- The padding follows the rules of the [CSS `padding` rule](http://www.w3schools.com/css/css_padding.asp), so: If the padding property has **four** values:
    - padding: 25px 50px 75px 100px;
        - top padding is 25px
        - right padding is 50px
        - bottom padding is 75px
        - left padding is 100px If the padding property has **three** values:
    - padding: 25px 50px 75px;
        - top padding is 25px
        - right and left paddings are 50px
        - bottom padding is 75px If the padding property has **two** values:
    - padding: 25px 50px;
        - top and bottom paddings are 25px
        - right and left paddings are 50px If the padding property has **one** value:
    - padding: 25px;
        - all four paddings are 25px If one value is passed, you can pass it a simple `integer` (ex.: `['cells_padding' => 1]`) or as an array (ex.: `['cells_padding' => [1]`).

For more information, see the unit tests in the `tests` folder, the methods `resolveOptions()` (where all options are validated) or the examples.

---

###  **Do you like this library?**
 **[LEAVE A ★](#js-repo-pjax-container)**

[](#----do-you-like-this-library----leave-a--1)

 or run
 `composer global require symfony/thanks && composer thanks`
 to say thank you to all libraries you use in your current project, this included!

---

###  Health Score

50

—

FairBetter than 95% of packages

Maintenance73

Regular maintenance activity

Popularity21

Limited adoption so far

Community13

Small or concentrated contributor base

Maturity78

Established project with proven stability

 Bus Factor2

2 contributors hold 50%+ of commits

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 ~162 days

Recently: every ~370 days

Total

20

Last Release

435d ago

Major Versions

0.5.0 → 1.0.02016-09-27

1.1.2 → 2.0.02017-09-25

2.0.2 → 3.0.02020-07-10

PHP version history (7 changes)0.1.0PHP ^5.4|^7.0

1.0.0PHP ^5.6|^7.0

2.0.0PHP ^7.0||^7.1

2.0.1PHP ^7.0

3.0.0PHP ^7.2

3.0.1PHP ^7.3|^8.0

3.0.3PHP ^7.4|^8.0

### Community

Maintainers

![](https://www.gravatar.com/avatar/dd91a553e180dea3a2e726643704e33a1d7e4c818b65ead1516ddf2f4e23ea43?d=identicon)[Aerendir](/maintainers/Aerendir)

---

Top Contributors

[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (650 commits)")[![kodiakhq[bot]](https://avatars.githubusercontent.com/in/29196?v=4)](https://github.com/kodiakhq[bot] "kodiakhq[bot] (576 commits)")[![Aerendir](https://avatars.githubusercontent.com/u/1968622?v=4)](https://github.com/Aerendir "Aerendir (284 commits)")[![leonardofalanga](https://avatars.githubusercontent.com/u/20907369?v=4)](https://github.com/leonardofalanga "leonardofalanga (1 commits)")

---

Tags

phparraymatrixtexttableplain texttxtplain txttext tabletxt table

###  Code Quality

Static AnalysisPHPStan, Rector

Type Coverage Yes

### Embed Badge

![Health badge](/badges/serendipity-hq-php-text-matrix/health.svg)

```
[![Health](https://phpackages.com/badges/serendipity-hq-php-text-matrix/health.svg)](https://phpackages.com/packages/serendipity-hq-php-text-matrix)
```

PHPackages © 2026

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