fyre/console

A CLI library.

v3.0.2 2024-06-29 06:52 UTC

Requires (Dev)

• friendsofphp/php-cs-fixer: ^3.59
• fyre/php-cs-fixer-config: ^1.0
• phpunit/phpunit: ^10

MIT

• elusivecodes

README

FyreConsole is a free, open-source CLI library for PHP.

Table Of Contents

• Installation
• Methods
• Colors
• Styles

Installation

Using Composer

composer require fyre/console

In PHP:

use Fyre\Console\Console;

Methods

Choice

Prompt to make a choice out of available options.

• $text is a string representing the prompt text.
• $options is an array containing the options.
• $default is a string representing the default option, and will default to null.

$choice = Console::choice($text, $options, $default);

Comment

Output comment text.

• $text is a string representing the text.
• $options is an array containing the color options.
  • color is a number representing the text color, and will default to null.
  • bg is a number representing the background color, and will default to null.
  • style is a number indicating the text style, and will default to Console::DIM.

Console::comment($text);

Confirm

Prompt to confirm with y/n options.

• $text is a string representing the prompt text.
• $default is a boolean representing the default option, and will default to true.

$confirm = Console::confirm($text, $default);

Error

Output text to STDERR.

• $text is a string representing the text.
• $options is an array containing the color options.
  • color is a number representing the text color, and will default to Console::RED.
  • bg is a number representing the background color, and will default to null.
  • style is a number indicating the text style, and will default to null.

Console::error($text, $options);

Get Height

Get the terminal height (in characters).

$height = Console::getHeight();

Get Width

Get the terminal width (in characters).

$width = Console::getWidth();

Info

Output info text.

• $text is a string representing the text.
• $options is an array containing the color options.
  • color is a number representing the text color, and will default to Console::BLUE.
  • bg is a number representing the background color, and will default to null.
  • style is a number indicating the text style, and will default to null.

Console::info($text, $options);

Input

Read a line of input.

$input = Console::input();

Progress

Output a progress indicator.

• $step is a number representing the current step, and will default to null.
• $totalSteps is a number representing the total steps, and will default to 10.

Console::progress($step, $totalSteps);

Sequential calls to this method will update the progress indicator. If the $step is set to null the indicator will be cleared.

Prompt

Prompt the user for input.

• $text is a string representing the prompt text.

$prompt = Console::prompt($text);

Style

Style text for terminal output.

• $text is a string representing the text.
• $options is an array containing the color options.
  • color is a number representing the text color, and will default to null.
  • bg is a number representing the background color, and will default to null.
  • style is a number indicating the text style, and will default to null.

$style = Console::style($text, $options);

Success

Output success text.

• $text is a string representing the text.
• $options is an array containing the color options.
  • color is a number representing the text color, and will default to Console::GREEN.
  • bg is a number representing the background color, and will default to null.
  • style is a number indicating the text style, and will default to null.

Console::success($text, $options);

Table

Output a table.

• $data is an array containing the table rows.
• $header is an array containing the table header columns, and will default to [].

Console::table($data, $header);

Warning

Output warning text.

• $text is a string representing the text.
• $options is an array containing the color options.
  • color is a number representing the text color, and will default to Console::YELLOW.
  • bg is a number representing the background color, and will default to null.
  • style is a number indicating the text style, and will default to null.

Console::warning($text, $options);

Wrap

Wrap text for terminal output.

• $text is a string representing the text.
• $maxWidth is a number representing the maximum character width of a line, and will default to the terminal width.

$wrap = Console::wrap($text, $maxWidth);

Write

Output text to STDOUT.

• $text is a string representing the text.
• $options is an array containing the color options.
  • color is a number representing the text color, and will default to Console::YELLOW.
  • bg is a number representing the background color, and will default to null.
  • style is a number indicating the text style, and will default to null.

Console::write($text, $options);

Colors

Console::BLACK; // 30
Console::RED; // 31
Console::GREEN; // 32
Console::YELLOW; // 33
Console::BLUE; // 34
Console::PURPLE; // 35
Console::CYAN; // 36
Console::WHITE; // 37
Console::GRAY; // 47
Console::DARKGRAY; // 100

Styles

Console::BOLD; // 1
Console::DIM; // 2
Console::ITALIC; // 3
Console::UNDERLINE; // 4
Console::FLASH; // 5