commando

突击队

一个优雅的 PHP CLI 库

Commando 是一个 PHP 命令行接口库,它美化和简化了用于命令行使用的 PHP 脚本的编写过程。

为什么?

PHP 的 $argv 变量和全局 $_SERVER['argv'] 让我感到不舒服, getopt 也并没有太大的改进,而大多数其他 PHP CLI 库在许多情况下都过于臃肿。Commando 直接进入工作模式,在处理 CLI 输入时消除了常见的框架代码,同时提供了一个清晰易读的接口。

安装

Commando 要求您运行 PHP 8.1 或更高版本。

Commando 遵循 PSR-0 规范,可以使用 Composer 安装。将 nategood/commando 添加到 composer.json 中：

"require": {
    "nategood/commando": "*"
}

如果您是 Composer 新手，请参阅以下内容：

• 下载并构建 Composer
• 使其 全局可用
• 切换到将要编写 Commando 脚本的目录，然后运行 composer install

目前，通过 Composer 安装是唯一支持的选项。

php hello.php --capitalize nate 你好,奈特! php hello.php -c -t Mr 'nate good' 你好,奈特·古德先生! php hello.php -ceet Mr 'nate good' 你好,奈特·古德先生! 需要注意的事项:

• Commando 实现了 ArrayAccess 接口,因此当您要为它检索值时,其行为与数组类似
• 对于"匿名"(即不是命名标志)参数,我们根据它们的数字索引进行访问
• 我们可以通过标志名称或其别名在数组中访问选项值
• 我们可以使用闭包在选项定义的过程中执行验证和映射操作

固有帮助

Commando 已内置自动的 --help 支持。使用此选项调用您的脚本：