答案:通过 php artisan make:command SendEmails 创建命令类,定义 signature 设置参数与选项,如 {user}、{--queue}、{--type=}、{--when=*},在 handle() 中用 argument() 和 option() 获取值,并可结合 ask、confirm 等方法实现交互,最终实现灵活的自动化命令。

Laravel 的 Artisan 命令工具非常强大,通过自定义命令可以实现自动化任务处理。创建带有选项和参数的自定义 Artisan 命令,能让你更灵活地控制命令行为。
生成自定义 Artisan 命令
使用以下 Artisan 命令生成一个新的命令类:
php artisan make:command SendEmails
这将在 app/Console/Commands 目录下创建 SendEmails.php 文件。确保在 AppServiceProvider 或配置中已注册命令(Laravel 8+ 默认自动发现)。
定义命令的签名与描述
在命令类的 signature 属性中定义命令名称、参数和选项。格式如下:
- {name}:必需参数
- {name?}:可选参数
- {name=default}:带默认值的参数
- {--option}:布尔选项(开关)
- {--option=} 或 {--option=value}:接收值的选项
- {--option=*}:可接收多个值的选项
示例:
protected $signature = 'send:emails {user} {--queue} {--type=} {--when=*}';
该签名表示:
- user:必须传入的用户标识
- --queue:是否加入队列(true/false)
- --type=:指定邮件类型,如 --type=welcome
- --when=*:可多次传递发送时间点
在命令中获取参数和选项
在 handle() 方法中使用 $this->argument() 和 $this->option() 获取输入值。
public function handle()
{
$user = $this->argument('user');
$queue = $this->option('queue');
$type = $this->option('type');
$when = $this->option('when');
$this->info("发送邮件给: $user");
$this->info("队列模式: " . ($queue ? '开启' : '关闭'));
$this->info("邮件类型: $type");
$this->info("发送时间: " . implode(', ', $when));
}
执行命令示例:
php artisan send:emails zhangsan --queue --type=welcome --when=now --when=later
交互式提示输入
你还可以在命令中动态请求用户输入:
- $this->ask('问题'):普通输入
- $this->secret('问题'):隐藏输入(如密码)
- $this->confirm('确认吗?'):确认对话
- $this->choice('选择', ['a','b']):选择项
例如:
if ($this->confirm('是否继续?')) {
$email = $this->ask('请输入邮箱');
}
基本上就这些。定义好签名,使用 argument 和 option 方法取值,再结合交互方法,就能构建出功能完整的自定义 Artisan 命令。不复杂但容易忽略细节,比如选项的等号写法和参数默认值设置。










