创建可用Artisan命令需三步：执行php artisan make:command SendWeeklyReport生成骨架类；定义$signature（如'report:weekly {--force} {user?}'）；在handle()中写业务逻辑并用$this->argument()、$this->option()获取参数，禁止在构造函数中读取。
怎么创建一个可用的 Artisan 命令
Artisan 命令本质是继承 Illuminate\Console\Command 的 PHP 类，注册到 Laravel 容器后由 artisan 二进制文件调用。不需手动写 CLI 入口，Laravel 已封装好解析逻辑。
执行 php artisan make:command SendWeeklyReport 就能生成骨架类，位置在 app/Console/Commands/SendWeeklyReport.php。关键点有三个：
-
protected $signature必须定义，格式如'report:weekly {--force} {user?}'，其中{user?}表示可选参数，{--force}是布尔型选项 -
handle()方法是实际执行入口，所有业务逻辑放这里，不要在__construct中做耗时操作（命令实例化早于参数解析） - 若需依赖注入（比如
Mailer或自定义服务），直接写在handle()方法签名里，Laravel 会自动解析——这是最常被忽略的便利点
为什么 handle() 里拿不到 $this->argument('xxx')
常见错误是把参数读取写在构造函数或初始化方法中，但此时 Artisan 还没解析命令行输入，$this->argument() 和 $this->option() 都返回 null 或空字符串。
正确做法只有一处：必须在 handle() 方法体内调用。例如：
立即学习“PHP免费学习笔记（深入）”；
public function handle()
{
$user = $this->argument('user'); // ✅ 正确
$force = $this->option('force'); // ✅ 正确
if (!$user) {
$this->error('Missing required argument: user');
return 1;
}
// ...
}
如果非要在其他方法中用参数，就把它作为参数传进去，别存为属性——因为命令对象生命周期短，且每次运行都是新实例。
如何让命令支持队列和失败重试
Artisan 命令默认同步执行，但有些任务（如导出大数据报表）需要异步化。Laravel 不强制要求命令类实现 ShouldQueue，但你得主动触发队列：
- 在
handle()中调用dispatch(new YourJob(...))，而不是直接执行耗时逻辑 - 若想整个命令本身可被队列调度（比如通过
php artisan queue:work拉起），需让命令类实现ShouldQueue接口，并确保它被dispatch()调用（不能直接php artisan your:command） - 注意：
ShouldQueue命令无法使用交互式方法（如$this->ask()），因为没有 STDIN 上下文；失败重试靠队列驱动配置（如 Redis 的 retry_after）控制，不是命令自身逻辑
本地调试时命令不生效或报错 Class not found
最常见原因是 Composer 自动加载未更新。Artisan 命令类属于 PSR-4 命名空间 App\Console\Commands，但如果你手动改过命名空间、移动了文件，或用了非标准目录结构，composer dump-autoload 就必须跑一次。
另外两个高频陷阱：
- 忘记在
app/Console/Kernel.php的$commands数组里注册新命令（Laravel 8+ 默认用自动发现，但仅限app/Console/Commands目录；若放在子目录如app/Console/Commands/Reports/，仍需手动添加） - 命令类用了错误的父类，比如继承了
Command但没加use Illuminate\Console\Command;，导致实际继承的是 PHP 内置Command（不存在），报Class 'Command' not found
复杂点在于：命令注册时机早于服务提供者启动，所以不能在 handle() 之前依赖尚未注册的绑定；而队列环境里，命令类反序列化时又不走常规容器解析流程——这两处最容易出隐性问题。
