前言

在平时项目中,有时需要对某些业务进行批处理,比如为了版本兼容,或者不同系统的数据同步等场景下,我们会选择自定义一些指令定时或即时的执行。

但是有很多命令需要读表,随着定义的指令逐渐变多,模型里本不涉及业务性的方法也越积越多,甚至某些指令删除了,但是对应的模型方法还在。所以为了不影响业务代码,我们会临时起一个项目专门作为指令处理。但还是有一个问题的是,因为还是以框架新启的项目,自然里面的那些控制器,路由,配置项加载其实并不需要。

于是我就想参考框架的 console 单独写一个指令集,当看了代码后,发现了一个我们平时很少用到的交互式输出,也就是输出带着问题。其实在很多带有控制台的软件中很常见,比如一些脚手架或包管理器安装前的询问。以下就大概介绍一些 Tp 控制台的大致运行流程和交互式输出的使用。

流程

1. Think 文件

这个就是 TP 命令执行 (php think command) 的入口文件,其实也是一个 PHP 文件。

打开网易新闻 查看精彩图片

2. think\Console.php

自定义指令和配置的载入,控制台输入和输出的实例化和运行的转发

打开网易新闻 查看精彩图片

3. Output.php

其他的文件后期再总结,这里主要介绍一下输出的内容样式 (颜色,背景,字体) 和交互式输出,因为这两个东西在 TP 框架文档中很少几乎没有提起并且有点炫。

打开网易新闻 查看精彩图片

输出:

1. 控制台输出的颜色背景设置

框架中背景设置可以在后面带上 --ansi,并且通过 info, error, warning 等方法。而 Tp 的样式设置是进行了封装,可以在 output/driver/Console.php 的 write 方法查看,output/formatter/Style.php 的 apply 方法就是通过 ANSI 控制码实现对控制台颜色的设置。

sprintf("\033[%sm%s\033[%sm", implode(';', $setCodes), $text, implode(';', $unsetCodes));

(1). 分析

\033 [% sm 代表开始设置标签,多个标签用分号;分隔
% s 表示要设置的字体
\033 [% sm 代表设置完成标签

(2). 拆分示例

echo "\033[31;44;4m如果,全世界我以为可以忘记,歌词哈~\r\n\033[39;49;24m";

左边中括号起,分号第一个是字体颜色开始值,第二个背景色开始值,第三个字体样式,右边中括号的结束值。

打开网易新闻 查看精彩图片
打开网易新闻 查看精彩图片

(3). ANSI 控制码

打开网易新闻 查看精彩图片

2. 交互式控制台

Output 类除了常用的样式性输出和 write 外还有 ask,confirm 等交互式输出,以下是该功能实现的 UML

打开网易新闻 查看精彩图片

(1). 一问一答

ask 方法第一个参数输入实例,第二个问题,第三个是默认值,第四个自行定义的校验器 (闭包),接收一个交互输出,可以通过错误次数让问题延续。

打开网易新闻 查看精彩图片
打开网易新闻 查看精彩图片

(2). 选项式

可以定义多个答案,这个有自带的校验器,代码见 output\question\Choice.php 中的 getDefaultValidator 方法。

第一个参输入实例,第二个问题,第三个问题选项,第四个默认项。

$output->choice($input, "请选择王者下面的几个英雄", ["典韦", "赵云", "亚瑟", "王昭君"], "亚瑟");

打开网易新闻 查看精彩图片

(3). 确认式

通过询问 yes or no 方式的交互输出,第一个参输入实例,第二个问题。

$output->confirm($input, "你确定要走下一步操作吗?");

打开网易新闻 查看精彩图片