[李景山php]每天TP5-20161224|thinkphp5-Console.php-1

namespace think;

use think\console\Command;// 控制台 命令
use think\console\command\Help as HelpCommand; // 帮助命令
use think\console\Input;// 输入
use think\console\input\Argument as InputArgument;// 输入参数
use think\console\input\Definition as InputDefinition; // 输入定义
use think\console\input\Option as InputOption;// 输入选项
use think\console\Output;// 输出
use think\console\output\driver\Buffer;// 输出缓存

class Console
{// 控制台类

private $name;// 私有句柄 名字
private $version;// 私有句柄 版本

/** @var Command[] */
private $commands = []; // 私有句柄 命令s 复数 仓库 存储

private $wantHelps = false;// 是否想要寻求帮助， 默认不是

private $catchExceptions = true;// 捕获异常
private $autoExit        = true;// 自动存在异常
private $definition;// 定义
private $defaultCommand;// 默认命名

private static $defaultCommands = [
"think\\console\\command\\Help",// 帮助
"think\\console\\command\\Lists",//列表
"think\\console\\command\\Build",//生成
"think\\console\\command\\Clear",//清理
"think\\console\\command\\make\\Controller",// 控制
"think\\console\\command\\make\\Model",// 模型
"think\\console\\command\\optimize\\Autoload",// 自动加载
"think\\console\\command\\optimize\\Config",//配置
"think\\console\\command\\optimize\\Route",//路由
];// 默认命令

public function __construct($name = 'UNKNOWN', $version = 'UNKNOWN')
{// 默认初始化
$this->name    = $name;// 转存 名字 默认 未知
$this->version = $version;// 转存 版本 默认 未知

$this->defaultCommand = 'list';// 默认命令 list 列表
$this->definition     = $this->getDefaultInputDefinition();// 默认定义， 通过函数，获取默认定义

foreach ($this->getDefaultCommands() as $command) {// 首先加载默认的 命令
$this->add($command);// 加载 是循环加载
}
}// 系统初始化 完成

public static function init($run = true)
{
static $console;// 初始化类
if (!$console) {// 如果没有被初始化
// 实例化console
$console = new self('Think Console', '0.1');// 实例化 自己，赋值 名字为 Think Console 版本 0.1
// 读取指令集
if (is_file(CONF_PATH . 'command' . EXT)) {// 如果说 指令集 配置文件 存在
$commands = include CONF_PATH . 'command' . EXT;// 读取配置文件
if (is_array($commands)) {// 如果是数组，也就是我们需要的配置格式
foreach ($commands as $command) {// 循环 加载
if (class_exists($command) && is_subclass_of($command, "\\think\\console\\Command")) {
// 注册指令
$console->add(new $command());// 加入 命令行
}
}
}
}
}// 无论如何 到这里之后，你会发现， $console 已经拥有自己的 实例化对象
// 更多的 区别就是 加载了 更多 commands 而已
if ($run) {// 默认运行
// 运行
return $console->run();// 执行运行
} else {
return $console;// 否则 返回实例化
}
}

/**
* @param       $command
* @param array $parameters
* @return Output|Buffer
*/
public static function call($command, array $parameters = [])
{//调用命令
$console = self::init(false);// 初始化自己，但是不运行，返回 实例化对象使用

array_unshift($parameters, $command);// 数组过滤处理

$input  = new Input($parameters);// 过滤参数
$output = new Output('buffer');// 获取 输出句柄

$console->setCatchExceptions(false);// 设置捕获异常
$console->find($command)->run($input, $output);// 找到对应的命令，然后执行他 的输入跟输出

return $output;
}// 编程看起来 越来越像是一个跟人对话的机制了，太像了，太方便了。

/**
* 执行当前的指令
* @return int
* @throws \Exception
* @api
*/
public function run()
{// 默认的 run
$input  = new Input();// 初始化输入
$output = new Output();// 初始 输出

$this->configureIO($input, $output);// 设置 IO

try {
$exitCode = $this->doRun($input, $output);// 尝试 运行一下
} catch (\Exception $e) {
if (!$this->catchExceptions) {// 如果说 不禁止 操作 抛出异常
throw $e;
}

$output->renderException($e);// 解析异常

$exitCode = $e->getCode();// 获取错误代码
if (is_numeric($exitCode)) {
$exitCode = (int)$exitCode;
if (0 === $exitCode) {
$exitCode = 1;
}
} else {
$exitCode = 1;
}// 处理错误代码，异常的情况 比正常的复杂
}

if ($this->autoExit) {
if ($exitCode > 255) {
$exitCode = 255;
}

exit($exitCode);
}

return $exitCode;// 否则 返回 错误代码  退出代码
}