malenki/ansi

Simple class to put some colors into your CLI PHP apps!

1.2.6 2014-03-03 12:56 UTC

This package is not auto-updated.

Last update: 2024-11-01 21:56:20 UTC


README

Latest Stable Version Total Downloads Latest Unstable Version License

Use colors and styles in PHP terminal apps!

Quick example to understand:

use Malenki\Ansi;

$a = new Ansi('Hello World!');
echo $a->red->bold->underline; // you get string in red color, bold and underline! :)

This was just little example, please read all this doc to see how to use Ansi! You can use metthod or magic getters, as you want, and chaining methods are available.

Install It

You can get code here, from github by cloning this repository, or you can use composer too. Ansi is available on Packagist!

So, to install it using composer, just put something similar to the following lines into your own composer.json project file:

{
    "require": {
        "malenki/ansi": "1.2.6",
    }
}

Play With It

What It can Do

You can use many foregrounds, backgrounds and styles:

  • Available foreground colors are: black, red, green, yellow, blue, purple, cyan and white.

  • Available background colors are: black, red, green, yellow, blue, magenta, cyan and gray.

  • Available styles are: faint, bold, italic and underline, but this effects may appear in different way into some terminals.

Ansi can also parse a string containing special XML-like tags to format it.

Magic getters are available too, and many methods are chainable. Look at the examples directory or read next section to see how to use Ansi.

Example Of Use

"Hello World!" in red:

use Malenki\Ansi;

$a = new Ansi('Hello World!');
echo $a->fg('red');

You can set string after constructor call using v() or value() methods, so you can keep color and formating and apply them for other strings:

$a = new Ansi();
$a->fg('red');
echo $a->v('Hello World!'); //in red
echo $a->v('Hello World again!'); //in red too

"Hello World!" in red, background yellow:

use Malenki\Ansi;
echo (new Ansi('Hello World!'))->fg('red')->bg('yellow');

"Hello World!" in red, background yellow and in bold:

use Malenki\Ansi;
echo (new Ansi('Hello World!'))->fg('red')->bg('yellow')->bold();

You can use rendered string too:

use Malenki\Ansi;
$str = (new Ansi('Hello World!'))->fg('red')->bg('yellow')->bold()->render();

All methods are chainable, except render().

Some magic getters allow new syntax, so, all foreground colors are available by calling their name as attribute, it is also true for faint, bold, italic and underline. Example:

echo (new Ansi('Hello World!'))->red->bold->underline;

For background colors, you must preceed its name by bg like you can see into this example:

echo (new Ansi('Hello World!'))->red->bold->underline->bg_blue;

More complex feature just added: parsing string having tags with same name as foreground colors and effects.

So an example to understand:

echo Ansi::parse('You can <bold>parse <cyan>string</cyan></bold> containing <red>some tags</red> to have <underline><yellow>some effects</yellow></underline> too!');

Enjoy!

MIT Open Source License

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.