## 创建命令 命令就是一个命令行程序,`Command` 类似于 HTTP 应用的 `Controller` 控制器,负责业务逻辑,不同的是命令行程序通常是处理复杂的数据处理逻辑,相比简单的 `CRUD` 操作要复杂很多。 ## 一个简单的命令 首先在配置文件 `manifest.php` 的 `commands` 或者 `commandPath` 中增加命令。 - commands ~~~ // 命令 'commands' => [ 'he' => [ \App\Console\Commands\HelloCommand::class, 'usage' => "\tEcho demo", 'options' => [ [['n', 'name'], 'description' => 'Your name'], ['say', 'description' => "\tSay ..."], ], ], ], ~~~ - commandPath 在 `commandPath` 指定的目录中任意创建一个文件,内容如下: ~~~ // 命令 return [ 'he' => [ \App\Console\Commands\HelloCommand::class, 'usage' => "\tEcho demo", 'options' => [ [['n', 'name'], 'description' => 'Your name'], ['say', 'description' => "\tSay ..."], ], ], ]; ~~~ 详解命令规则: - 命令名称: `he` - 命令类的类名:`\App\Console\Commands\HelloCommand::class` - `description` 命令的描述,命令 `-h` 时显示,(可不定义) - `options` 命令的参数,参数 `-h` 时显示,(可不定义) - `['n', 'name']`、`'say'` 命令参数的名称,可为字符或数组,**所有参数都必须在这里注册方可使用**。 - `options.description` 参数的描述,参数 `COMMAND -h` 时显示,(可不定义) 当在 [mix-phar](https://github.com/mix-php/mix-phar) 中开发时还可以进行单命令配置,使整个 phar 文件为一个命令,配置方式如下: ~~~ // 命令 'commands' => [ \App\Console\Commands\HelloCommand::class, 'usage' => "\tEcho demo", 'options' => [ [['n', 'name'], 'description' => 'Your name'], ['say', 'description' => "\tSay ..."], ], ], ~~~ 创建命令类,代码如下: ~~~ <?php namespace App\Console\Commands; use Mix\Console\CommandLine\Flag; /** * Class HelloCommand * @package App\Console\Commands * @author liu,jian <coder.keda@gmail.com> */ class HelloCommand { /** * 主函数 */ public function main() { $name = Flag::string(['n', 'name'], 'Xiao Ming'); $say = Flag::string('say', 'Hello, World!'); println("{$name}: {$say}"); } } ~~~ ## 命名空间与文件位置的关系 控制器定义的命名空间为: ~~~ namespace App\Console\Commands; ~~~ 因为根命名空间 `App` 在 `composer.json` 内定义的路径为 : ~~~ "psr-4": { "App\\": "app/" }, ~~~ 所以控制器的完整路径为: ~~~ app/Console/Commands/HelloCommand.php ~~~ ## 命令行执行 执行上面写的命令。 ~~~shell // 不带参数 php bin/mix.php he // 带参数 php bin/mix.php he -n "Xiao Hua" --say=Hi ~~~