命令行

Hyperf 的命令行默认由 hyperf/command 组件提供，而该组件本身也是基于 symfony/console 的抽象。

安装

通常来说该组件会默认存在，但如果您希望用于非 Hyperf 项目，也可通过下面的命令依赖 hyperf/command 组件：

  1. composer require hyperf/command

查看命令列表

直接运行 php bin/hyperf.php 不带任何的参数即为输出命令列表。

自定义命令

生成命令

如果你有安装 hyperf/devtool 组件的话，可以通过 gen:command 命令来生成一个自定义命令：

  1. php bin/hyperf.php gen:command FooCommand

执行上述命令后，便会在 app/Command 文件夹内生成一个配置好的 FooCommand 类了。

定义命令

定义该命令类所对应的命令有两种形式，一种是通过 $name 属性定义，另一种是通过构造函数传参来定义，我们通过代码示例来演示一下，假设我们希望定义该命令类的命令为 foo:hello：

$name 属性定义：

  1. <?php
  3. declare(strict_types=1);
  5. namespace App\Command;
  7. use Hyperf\Command\Command as HyperfCommand;
  8. use Hyperf\Command\Annotation\Command;
  10. /**
  11.  * @Command
  12.  */
  13. class FooCommand extends HyperfCommand
  14. {
  15.     /**
  16.      * 执行的命令行
  17.      *
  18.      * @var string
  19.      */
  20.     protected $name = 'foo:hello';
  21. }

构造函数传参定义：

  1. <?php
  3. declare(strict_types=1);
  5. namespace App\Command;
  7. use Hyperf\Command\Command as HyperfCommand;
  8. use Hyperf\Command\Annotation\Command;
  10. /**
  11.  * @Command
  12.  */
  13. class FooCommand extends HyperfCommand
  14. {
  15.     public function __construct()
  16.     {
  17.         parent::__construct('foo:hello');    
  18.     }
  19. }

定义命令类逻辑

命令类实际运行的逻辑是取决于 handle 方法内的代码，也就意味着 handle 方法就是命令的入口。

<?php

declare(strict_types=1);

namespace App\Command;

use Hyperf\Command\Command as HyperfCommand;
use Hyperf\Command\Annotation\Command;

/**
 * @Command
 */
class FooCommand extends HyperfCommand
{
    /**
     * 执行的命令行
     *
     * @var string
     */
    protected $name = 'foo:hello';

    public function handle()
    {
        // 通过内置方法 line 在 Console 输出 Hello Hyperf.
        $this->line('Hello Hyperf.', 'info');
    }
}

定义命令类的参数

在编写命令时，通常是通过 参数 和 选项 来收集用户的输入的，在收集一个用户输入前，必须对该 参数 或 选项 进行定义。

参数

假设我们希望定义一个 name 参数，然后通过传递任意字符串如 Hyperf 于命令一起并执行 php bin/hyperf.php foo:hello Hyperf 输出 Hello Hyperf，我们通过代码来演示一下：

<?php

declare(strict_types=1);

namespace App\Command;

use Hyperf\Command\Annotation\Command;
use Hyperf\Command\Command as HyperfCommand;
use Symfony\Component\Console\Input\InputArgument;

/**
 * @Command
 */
class FooCommand extends HyperfCommand
{
    /**
     * 执行的命令行
     *
     * @var string
     */
    protected $name = 'foo:hello';

    public function handle()
    {
        // 从 $input 获取 name 参数
        $argument = $this->input->getArgument('name') ?? 'World';
        $this->line('Hello ' . $argument, 'info');
    }

    protected function getArguments()
    {
        return [
            ['name', InputArgument::OPTIONAL, '这里是对这个参数的解释']
        ];
    }
}

执行 php bin/hyperf.php foo:hello Hyperf 我们就能看到输出了 Hello Hyperf 了。