Laravel 默认不支持“出现即必须传值”的命令行选项（如 --test 必须后跟参数），本文提供一种优雅的扩展方案：通过自定义 Parser 和 Command 基类，引入 == 语法（如 --option==）来声明强约束选项，并完全兼容 Symfony 底层的 InputOption::VALUE_REQUIRED。
laravel 默认不支持“出现即必须传值”的命令行选项（如 `--test` 必须后跟参数），本文提供一种优雅的扩展方案：通过自定义 parser 和 command 基类，引入 `==` 语法（如 `--option==`）来声明强约束选项，并完全兼容 symfony 底层的 `inputoption::value_required`。
在 Laravel 中，Artisan 命令的选项签名（如 {--t|test=}）虽文档称 “= 表示用户 must 指定值”，但实际行为是：php artisan mycommand -t 仍可执行，且 $this->option('test') 返回 null —— 即使你设置了默认值（如 {--t|test=42}），该默认值也仅在选项完全未出现时生效，而不会覆盖无值调用。这与开发者对“必须指定值”的直觉严重不符。
根本原因在于：Laravel 的 IlluminateConsoleParser 在解析选项时，统一将所有选项注册为 InputOption::VALUE_OPTIONAL，并未透传 Symfony 支持的 VALUE_REQUIRED 模式。尽管 Symfony 原生支持（通过 InputOption::VALUE_REQUIRED 构造），Laravel 却主动放弃了这一能力。
为此，我们可通过轻量级扩展恢复该功能。核心思路是：
✅ 自定义 Parser 类，识别新语法（如 --test==、--tags==*、--env==production）并生成 VALUE_REQUIRED 选项；
✅ 继承 Command 类，重写 configureUsingFluentDefinition()，注入自定义 Parser；
✅ 保持向后兼容 —— 未使用 == 的旧签名仍交由 Laravel 原生解析。
✅ 实现步骤
1. 创建自定义 Parser（app/Console/Parser.php）
<?php namespace AppConsole;
use IlluminateConsoleParser as BaseParser;
use SymfonyComponentConsoleInputInputOption;
class Parser extends BaseParser
{
protected static function parseOption($token): InputOption
{
[$mytoken, $description] = static::extractDescription($token);
$matches = preg_split("/\s*\|\s*/", $mytoken, 2);
$shortcut = $matches[0] ?? null;
$mytoken = $matches[1] ?? $mytoken;
return match (true) {
str_ends_with($mytoken, "==") => new InputOption(
trim($mytoken, "="),
$shortcut,
InputOption::VALUE_REQUIRED,
$description
),
str_ends_with($mytoken, "==*") => new InputOption(
trim($mytoken, "=*"),
$shortcut,
InputOption::VALUE_REQUIRED | InputOption::VALUE_IS_ARRAY,
$description
),
preg_match("/(.+)==*(.+)/", $mytoken, $m) => new InputOption(
$m[1],
$shortcut,
InputOption::VALUE_REQUIRED | InputOption::VALUE_IS_ARRAY,
$description,
preg_split('/,s?/', $m[2])
),
preg_match("/(.+)==(.+)/", $mytoken, $m) => new InputOption(
$m[1],
$shortcut,
InputOption::VALUE_REQUIRED,
$description,
$m[2]
),
default => parent::parseOption($token),
};
}
}
2. 创建基类 Command（app/Console/Command.php）
<?php namespace AppConsole;
use IlluminateConsoleCommand as BaseCommand;
use ReflectionException;
use ReflectionMethod;
class Command extends BaseCommand
{
protected function configureUsingFluentDefinition(): void
{
[$name, $arguments, $options] = AppConsoleParser::parse($this->signature);
// 调用父类（IlluminateConsoleCommand）的 __construct，跳过 Laravel 的初始化逻辑
$parentClass = get_parent_class(BaseCommand::class);
$reflection = new ReflectionMethod($parentClass, '__construct');
$reflection->invoke($this, $name);
$this->getDefinition()->addArguments($arguments);
$this->getDefinition()->addOptions($options);
}
}
3. 在业务命令中使用（app/Console/Commands/MyCommand.php）
<?php namespace AppConsoleCommands;
use AppConsoleCommand;
class MyCommand extends Command
{
protected $signature = 'mycommand {--t|test==} {--tags==*} {--env==production}';
protected $description = '演示强约束选项';
public function handle()
{
$test = $this->option('test'); // 必须提供：artisan mycommand --test=value
$tags = $this->option('tags'); // 数组必填：--tags=a,b,c
$env = $this->option('env'); // 必填且有默认：--env=staging 或直接 --env=production（默认）
$this->info("Test: {$test}");
$this->info("Tags: " . implode(', ', $tags));
$this->info("Env: {$env}");
}
}
⚠️ 注意事项与验证
- 错误行为触发：运行 php artisan mycommand --test（无值）将抛出 RuntimeException，提示 “The --test option requires a value.”，由 Symfony 控制台原生保障；
- 数组选项：{--tags==*} 要求至少一个值（如 --tags=a,b,c），空数组 --tags= 仍被拒绝；
- 默认值逻辑：{--env==production} 中 production 仅在 --env 完全未出现 时生效；若显式写出 --env 却不带值，仍报错；
- 升级安全：此方案未修改 Laravel 核心，仅扩展，Laravel 升级时只需检查 Parser::parseOption() 签名是否变更（目前稳定）；
- IDE 友好性：建议在 Command 基类顶部添加 PHPDoc，注明签名语法扩展。
通过这一设计，你获得了与 Symfony 原生一致的选项语义，同时保持 Laravel 开发体验无缝衔接 —— 真正实现“出现即必须赋值”的契约式 CLI 接口。
