PHP CLI Console

, _(*1)

, _(*2)

Installation

Download a latest package or use Composer:, _(*3)

composer require czproject/phpcli

PhpCli requires PHP 8.0 or later, optionaly Readline extension., _(*4)

Usage

``` php use CzProject\PhpCli\ConsoleFactory;, _(*5)

require DIR . '/vendor/autoload.php';, _(*6)

$console = ConsoleFactory::createConsole();, _(*7)

// output $console->output('CzProject CLI Simple Console', 'green') ->nl() // new line ->output('Hey!', 'yellow') ->nl() ->output('Fred!', 'blue') ->nl() ->output('Fred is dead!', 'red') ->nl() ->output(['nooooooo...!', ' ', 'But, no problem!'], 'gray') ->nl() ->output('The end.') ->nl();, _(*8)

// input $username = $console->input('Enter your name');, _(*9)

$console->output('Hello! ', 'blue') ->output($username, 'green') ->output(' [user]', 'yellow') ->nl() // print new line ->output('Bye!', 'blue') ->nl();, _(*10)

// input with default value $username = $console->input('Enter your name', 'John');, _(*11)

// confirm $agree = $console->confirm('Do you want to continue?');, _(*12)

// confirm with default value $canQuit = $console->confirm('Really?', TRUE);, _(*13)

// select $value = $console->select('Select color:', [ 'value' => 'label', '#ff0000' => 'Red', '#00ff00' => 'Green', '#0000ff' => 'Blue', ]);, _(*14)

// select with default value $value = $console->select('Select color:', [ 'value' => 'label', '#ff0000' => 'Red', '#00ff00' => 'Green', '#0000ff' => 'Blue', ], '#ff0000');, _(*15)



## Parameters

**Arguments**

```php
$name = $console->getArgument(0)->getValue(); // string|NULL

$size = $console->getArgument(1, 'int')
    ->setRequired()
    ->addRule(function ($value) {
        return $value > 0;
    })
    ->getValue();

$price = $console->getArgument(2, 'float') // float
    ->setDefaultValue(100.0)
    ->getValue();

Options, _(*16)

$name = $console->getOption('name')->getValue(); // string|NULL

$size = $console->getOption('size', 'int')
    ->setRequired()
    ->addRule(function ($value) {
        return $value > 0;
    })
    ->getValue();

$price = $console->getOption('price', 'float') // float
    ->setDefaultValue(100.0)
    ->getValue();

$words = $console->getOption('word')
    ->setRepeatable()
    ->getValue();

Supported types, _(*17)