包简介

An ANSI library for PHP

README 文档

README

Allows you to create ANSI strings with ease in PHP.

Java Version: See here

Usage

Note: It is not guaranteed that all of these ANSI codes will work on all terminals. See here for a list of compatible terminals.

$stringBuilder = new \Ansi\StringBuilder;

echo $stringBuilder
         ->raw('Hello, ')
         ->underline('John Doe')
         ->resetUnderline()
         ->raw('. ')
         ->raw('This is ')
         ->color16(\Ansi\Color16::FG_RED, 'red')
         ->raw('.')
         .PHP_EOL;

`\Ansi\StringBuilder`

Note: Each of these functions takes an optional string parameter which will be added immediately after the ANSI code is applied. They also all follow the Fluent Design Pattern. The string builder itself implements the __toString magic method, and as such can be treated as a string.

Method	Result
`bold()`	Sets the bold flag.
`dim()`	Sets the dim flag.
`underline()`	Sets the underline flag.
`blink()`	Sets the blink flag.
`invertColor()`	Set the invert colors flag.
`hide()`	Sets the hidden flag.
`reset()`	Resets all colors and flags to default.
`resetBold()`	Resets the bold flag.
`resetDim()`	Resets the dim flag.
`resetUnderline()`	Sets the underline flag.
`resetBlink()`	Resets the blink flag.
`resetInvertColors()`	Resets the invert colors flag.
`resetHidden()`	Resets the hidden flag.
`color16(int)`	Sets the current 16-bit foreground or background color. (See `\Ansi\Color16`)
`color256(int)`	Sets the current 256-bit color. (See here for a list of color codes.)
`backgroundColor256(int)`	Sets the current 256-bit background color. (See here for a list of color codes.)

Utility Methods

Method	Result
`raw(string)`	Adds a raw string.
`ansi(value)`	Escapes and appends a custom ANSI value.
`stripAnsi()`	Removes all ANSI sequences from the StringBuilder.
`empty()`	Empties out the StringBuilder.

`\Ansi\Color16`

The Color16 class is a utility class for 16-bit color codes.

Note: Each of these constants needs to be prefixed with either FG_ when using it as a foreground color or BG_ when using it as a background color.

RESET
BLACK
RED
GREEN
YELLOW
BLUE
MAGENTA
CYAN
LIGHT_GRAY
DARK_GRAY
LIGHT_RED
LIGHT_GREEN
LIGHT_YELLOW
LIGHT_BLUE
LIGHT_MAGENTA
LIGHT_CYAN
WHITE

nafisc/ansi-util 适用场景与选型建议

nafisc/ansi-util 是一款基于 PHP 开发的 Composer 扩展包，目前已累计 1.69k 次下载、GitHub Stars 达 3，最近一次更新时间为 2019 年 05 月 18 日，在 PHP 生态内属于活跃度较高的组件。

我们在过去多个企业项目中使用过 nafisc/ansi-util 或与其功能相近的方案，如果你在选型或落地过程中遇到问题，例如 版本兼容、二次改造、私有化封装、与内部系统对接、生产 BUG 排查，欢迎联系我们协助评估。

围绕 nafisc/ansi-util 我们能提供哪些服务？

定制开发 / 二次开发

基于 nafisc/ansi-util 在你已有业务上做功能扩展、字段裁剪、UI 适配、与内部账号 / 权限 / 日志系统的深度对接。

BUG 修复 & 性能优化

线上偶发问题、内存泄漏、慢查询、并发异常等排查修复；针对高流量场景做缓存、队列、索引层面的调优。

项目外包 & 长期维护

承接完整的项目从需求 → 设计 → 开发 → 上线 → 长期运维；也可按月提供技术保姆服务。

yvsm@zunyunkeji.com QQ：316430983 微信：yvsm316 西安尊云信息科技 · 专注 PHP / Go / 分布式系统研发

nafisc/ansi-util

包简介