PHPackages                             rxx/colors - 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. [CLI &amp; Console](/categories/cli)
4. /
5. rxx/colors

AbandonedArchivedLibrary[CLI &amp; Console](/categories/cli)

rxx/colors
==========

Convenient ANSI color printing for PHP CLI apps

v1.0.0(11y ago)21121GPL v3.0PHPPHP &gt;=5.3.0

Since Nov 2Pushed 11y ago1 watchersCompare

[ Source](https://github.com/RosyDoubleCross/php-cli-colors)[ Packagist](https://packagist.org/packages/rxx/colors)[ Docs](https://github.com/RosyDoubleCross/php-cli-colors)[ RSS](/packages/rxx-colors/feed)WikiDiscussions master Synced 1mo ago

READMEChangelogDependenciesVersions (2)Used By (1)

rxx/colors
==========

[](#rxxcolors)

This tiny one-class library provides a set of static methods implementing convenient ANSI color printing for PHP CLI apps via inline formatting codes.

Usage
-----

[](#usage)

Simply require the composer package and use the methods found in the class RXX\\Colors\\Colors.

The most convenient method is **Colors::cprint**, which requires at least one argument, a string containing color formatting codes. These codes follow the syntax "**%fb;**", as follows:

- **%** is a literal percent sign identifying the beginning of the code
- **f** is a foreground color identifier (see below); if uppercase, it is the bold version of the color; if "x", the code becomes an ANSI reset
- **b** is an optional background color identifier (see below); if omitted, the background defaults to black
- **;** is an optional literal semicolon identifying the end of the code

Color identifiers:

- k = black
- r = red
- g = green
- y = yellow
- b = blue
- m = magenta
- c = cyan
- w = white
- x = reset

By default, cprint echoes the formatted string, appending a newline and an ANSI reset. The method takes optional arguments to toggle these behaviors:

```
public static function cprint($msg, $appendNewline = true, $autoReset = true, $return = false)
```

If **$appendNewline** is true, a newline is appended to the input. If **$autoReset** is true, an ANSI reset code is appended to the output. If **$return** is true, the resulting string is returned rather than echoed.

The other methods are either used indirectly by cprint or are for niche purposes. The source is mostly self-explanatory (code language for "I'm too lazy to document this right now"). Mess around with it as you please.

Examples
--------

[](#examples)

```
require_once __DIR__ . '/../vendor/autoload.php';

use RXX\Colors\Colors;

// basic usage
Colors::cprint('%b;various %c;shades %B;of %C;blue');
Colors::cprint('%Rw;red on white');

// bars in blue and red
Colors::cprint('%kB;     %x;     %kR;     ');

// returning a string, without newline
$bright = Colors::cprint('%Y;YELLOW!', false, true, true);
echo "bright '{$bright}'\n";

// continuing color without reset
Colors::cprint('w listing in bright green on blue:%Gb;', true, false);
system('w');

// print newline and reset
Colors::cprint('');
```

License
-------

[](#license)

Copyright (C) 2013 Joe Lafiosca

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see .

###  Health Score

28

—

LowBetter than 54% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity13

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity58

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

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

Unknown

Total

1

Last Release

4208d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/55e5444ea1a3af302281a8af4f159a7820b8f3ae4763d3cca9f184093448d0c4?d=identicon)[lafiosca](/maintainers/lafiosca)

---

Top Contributors

[![lafiosca](https://avatars.githubusercontent.com/u/9442662?v=4)](https://github.com/lafiosca "lafiosca (1 commits)")

---

Tags

clicoloransi

### Embed Badge

![Health badge](/badges/rxx-colors/health.svg)

```
[![Health](https://phpackages.com/badges/rxx-colors/health.svg)](https://phpackages.com/packages/rxx-colors)
```

###  Alternatives

[symfony/console

Eases the creation of beautiful and testable command line interfaces

9.8k1.1B11.3k](/packages/symfony-console)[kevinlebrun/colors.php

Colors for PHP CLI scripts

3426.7M45](/packages/kevinlebrun-colorsphp)[alecrabbit/php-console-spinner

Extremely flexible spinner for \[async\] php cli applications

24032.0k2](/packages/alecrabbit-php-console-spinner)[alecrabbit/php-cli-snake

Lightweight cli spinner with zero dependencies

29211.3k5](/packages/alecrabbit-php-cli-snake)[inhere/console

php console library, provide console argument parse, console controller/command run, color style, user interactive, information show.

3477.4k12](/packages/inhere-console)[malenki/ansi

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

4345.0k1](/packages/malenki-ansi)

PHPackages © 2026

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