Laravel Artisan命令获取参数须严格区分参数与选项：必填参数如{user}用$this->argument('user')获取，可选参数如{role?}同理，选项如{--force}必须用$this->option('force')获取，不可混用。
在 Laravel 中，命令行 Artisan 命令获取参数的正确写法，关键在于定义方式与解析方式严格匹配，不能混淆“参数（arguments）”和“选项（options）”。
定义参数：在 signature 属性中声明
Artisan 命令的参数需在命令类的 $signature 属性中明确定义，语法遵循 Symfony Console 规范：
-
必填参数：直接写名称，如
user -
可选参数：加
?，如user? -
带默认值的可选参数：用
=赋值，如role=guest -
数组参数：加
*，如id*（支持多个值，如php artisan demo:process 1 2 3）
示例：protected $signature = 'demo:send {user} {role?} {--force}';
获取参数：使用 $this->argument() 和 $this->option()
务必区分调用方法：
- 通过
$this->argument('user')获取{user}这类花括号定义的位置参数 - 通过
$this->option('force')获取--force这类双横线定义的选项（flags） - 不要混用：
$this->argument('force')会返回null，$this->option('user')同样无效
常见错误写法及修正
❌ 错误：在 signature 中写成 {--user} 却用 $this->argument('user') 取值
✅ 正确：若想作为选项传参，应写 --user=xxx 并用 $this->option('user')
❌ 错误：未声明参数却直接调用 $this->argument('missing')（会报错或返回 null）
✅ 正确：先判断是否存在 —— if ($this->hasArgument('user')) { ... } 或使用 optional($this->argument('role'))
完整示例命令类
```php
class DemoSendCommand extends Command
{
protected $signature = 'demo:send {user} {role? : User role, default is user} {--force : Force send even if disabled}';
protected $description = 'Send message to user';
public function handle()
{
$user = $this->argument('user'); // ✅ 必填参数
$role = $this->argument('role') ?? 'user'; // ✅ 可选参数 + 默认值
$force = $this->option('force'); // ✅ 布尔选项
$this->info("Sending to {$user} (role: {$role})".($force ? ' [forced]' : ''));
}
}
```
