Download the PHP package mix/cli without Composer

OpenMix 出品：https://openmix.org

Mix CLI

PHP CLI Interactive Commander

PHP 命令行交互指挥官

go 版本：https://github.com/mix-go/xcli

Overview

一个命令行交互与指挥管理工具，它可以让单个 CLI 可执行多种功能，同时它还包括命令行参数获取、全局异常捕获与处理等命令行开发常用功能。

Installation

Quick start

上面是采用闭包，也可以使用对象

查看整个命令行程序的帮助

查看命令行程序的版本信息

查看 hello 命令的帮助

执行 hello 命令

Flag 参数获取

参数规则 (部分UNIX风格+GNU风格)

• 命令：
  • 第一个参数，可以为空：home
• 选项：
  • 短选项：一个中杠，如 -d、-rf
  • 长选项：二个中杠，如：--debug
• 选项值：
  • 无值：-d、-rf、 --debug
  • 有值(空格)：-v vvv、--page 23
  • 有值(等号)：-s=test、--name=john
• 参数：
  • 没有定义 - 的参数：arg0

获取选项，可以获取 string、bool、int、float 多种类型，也可以指定默认值。

获取第一个参数

获取全部参数

Daemon 后台执行

我们可以通过配合 flag 获取参数，实现通过某几个参数控制程序后台执行。

• 使用了 Swoole Daemon 方法

Middleware 与 Handle exception

可以使用全局中间件给所有命令捕获异常，也可以单独对某个命令配置中间件

Application

我们在编写代码时，可能会要用到 App 中的一些信息。

Singleton 单命令

当我们的 CLI 只有一个命令时，只需要配置一下 Singleton：

$cmd = new Mix\Cli\Command([
    'name' => 'hello',
    'short' => 'Echo demo', 
    'run' => function () {
        // do something
    },
    'singleton' => true,
]);

命令的 Options 将会在 -h/--help 中打印

$ php app.php
Usage: app.php [OPTIONS] COMMAND [ARG...]

Command Options:
  -n, --name    Your name

Global Options:
  -h, --help    Print usage
  -v, --version Print version information

Run 'app.php COMMAND --help' for more information on a command.

Developed with Mix PHP framework. (openmix.org/mix-php)

License

Apache License Version 2.0, http://www.apache.org/licenses/