malios/php-to-ascii-table

A PHP library to generate plain text tables.

v3.0.0 2022-02-13 20:15 UTC

This package is not auto-updated.

Last update: 2024-12-24 10:44:13 UTC


README

A small PHP library for generating plain text tables.

example table

Getting Started

Prerequisites

  • PHP >= 7
  • ext-mbstring
  • Optionally Install php-ds extension (Recommended).

Installation

Install via composer:

$ composer require malios/php-to-ascii-table

Usage

<?php
    $builder = new \AsciiTable\Builder();
    
    $builder->addRows([
        [
            'Order No' => 'A0001',
            'Product Name' => 'Intel CPU',
            'Price' => 700.00,
            'Quantity' => 1
        ],
        [
            'Order No' => 'A0002',
            'Product Name' => 'Hard disk 10TB',
            'Price' => 500.00,
            'Quantity' => 2
        ],
        [
            'Order No' => 'A0003',
            'Product Name' => 'Dell Laptop',
            'Price' => 11600.00,
            'Quantity' => 8
        ],
        [
            'Order No' => 'A0004',
            'Product Name' => 'Intel CPU',
            'Price' => 5200.00,
            'Quantity' => 3
        ]
    ]);
    
    $builder->addRow([
        'Order No' => 'A0005',
        'Product Name' => 'A4Tech Mouse',
        'Price' => 100.00,
        'Quantity' => 10
    ]);

    $builder->setTitle('Product List');
    
    echo $builder->renderTable();
   

    // Show only some fields
    
    $builder->showColumns(['Order No', 'Product Name', 'Quantity']);
    
    echo $builder->renderTable();
    

Build table from objects

You can build table form any object that implements JsonSerializable interface.

<?php
    
    class Person implements \JsonSerializable 
    {
        private $name;
        
        private $age;
        
        public function __construct(string $name, int $age) {
            $this->name = $name;
            $this->age = $age;
        }
        
        public function jsonSerialize()
        {
            return [
                'name' => $this->name,
                'age' => $this->age
            ];
        }
    }
    
    $builder = new \AsciiTable\Builder();
    
    $builder->addRow(new Person('John', 25));
    $builder->addRow(new Person('Bill', 30));
    
    echo $builder->renderTable();

Contributing

All contributors are welcome. You can open a new issue or submit a pull request. See CONTRIBUTING.md for details.

License

This project is licensed under the MIT License - see the LICENSE.md file for details.