Download the PHP package bebat/console-color without Composer
On this page you can find all versions of the php package bebat/console-color. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package console-color
Console Color
Console Color is a lightweight PHP 8.1+ library for adding color & other styles to text in the command line.
- Installation
- Basic Usage
- Environment Variables
- Included Styles
- Basic Styles
- Text
- Underline
- Foreground & Background Color
- 256 & True Color
- Composite Styles
Installation
The Console Color library can be installed via Composer:
Basic Usage
To apply style to a text you need an instance of BeBat\ConsoleColor\Style. With that you can apply a style object to some text:
The Style class will try to determine if console output can be styled automatically (more details on this can be found in the Environment Variables section below). By default, it looks at STDOUT and checks if it is a TTY. If you are using a different output type (such as a php:// I/O stream) you may pass that to Style() to have it determine if that stream supports styling:
You may use the force() method to make Style always apply styles to text, regardless of whether it thinks the output resource supports it:
Environment Variables
In addition to checking if STDOUT is a TTY, Style will look at several environment variables to determine if styles should be applied, and what level of support the user's terminal has for styles.
FORCE_COLOR- If the user has setFORCE_COLORstyling will be applied, even ifStyledoesn't think the output is a TTY.NO_COLOR- If the user has setNO_COLORstyling will be disabled.NO_COLORtakes precedence overFORCE_COLOR.TERM-Stylewill checkTERMto see if it supports 256 colors.COLORTERM- IfCOLORTERMis set totruecolorthenStylewill apply RGB based colors.
Included Styles
Style::apply() accepts an instance of StyleInterface, and Console Color includes a number of styles that implement this interface.
To see what styles your terminal supports and what they look like, run the included sample.php file.
Basic Styles
Style\Text, Style\Underline, Style\Color, and Style\BackgroundColor are backed enumerations which helps to make Console Color's API extremely clean. These styles have the broadest support in most terminals (with some exceptions).
Text
Style\Text::None- no styleStyle\Text::Bold- bold text (may also "brighten" the color in some terminals)Style\Text::Faint- dim text colorStyle\Text::Italic- italicsStyle\Text::Underline- underlineStyle\Text::Blink- blinking text (use wisely 😉)Style\Text::Reverse- swap foreground and background colorsStyle\Text::Concealed- hides the text (it is still present and can be selected)Style\Text::Strike- strikethrough, not supported in all terminalsStyle\Text::DoubleUnderline- double or bold underline, not supported in all terminalsStyle\Text::Overline- line over text, not supported in all terminalsStyle\Text::Superscript- superscript text, rarely supportedStyle\Text::Subscript- subscript text, rarely supported
Underline
Custom underline styles are not widely supported but some terminals do include them. Most, if not all, will fall back on just displaying a single underline.
Style\Underline::SingleStyle\Underline::DoubleStyle\Underline::WavyStyle\Underline::DottedStyle\Underline::Dashed
Foreground & Background Color
Style\Color and Style\BackgroundColor both support the same values and have an identical API.
Style\Color::BlackStyle\Color::RedStyle\Color::GreenStyle\Color::YellowStyle\Color::BlueStyle\Color::MagentaStyle\Color::CyanStyle\Color::WhiteStyle\Color::DefaultStyle\Color::BrightBlackStyle\Color::BrightRedStyle\Color::BrightGreenStyle\Color::BrightYellowStyle\Color::BrightBlueStyle\Color::BrightMagentaStyle\Color::BrightCyanStyle\Color::BrightWhite
256 & True Color
Most terminal programs support 256 color output, and many now also support 24-bit "true" colors. Console Color can apply those colors to the foreground, background, or underline color through the Style\Color256 and Style\ColorRGB classes.
Style\Color256::foreground(int $code)- apply a 256 color to the textStyle\Color256::background(int $code)- apply a 256 color to the backgroundStyle\Color256::underline(int $code)- apply a 256 color to an underline (see composite styles below)Style\ColorRGB::foreground(int $red, int $green, int $blue)- apply an RGB color to the textStyle\ColorRGB::background(int $red, int $green, int $blue)- apply an RGB color to the backgroundStyle\ColorRGB::underline(int $red, int $green, int $blue)- apply an RGB color to an underline (see composite styles below)
Composite Styles
It's possible to apply more than one style to your text by using the Style\Composite() class. For example, to apply color to both the foreground and background:
Style\Composite() is also required if you want to add color to an underline:
Style\Composite() can actually take as many styles as you need to apply:
