应使用Artisan命令生成器创建命令类:执行php artisan make:command SendDailyReport生成骨架文件,编辑$signature定义名称与参数,于handle()中编写逻辑并用$this->info()输出状态。

如果您希望在 Laravel 项目中封装重复性任务、自动化数据处理或集成运维脚本,则需要创建可被 php artisan 直接调用的自定义命令。以下是实现该目标的多种可行方法:
一、使用 Artisan 命令生成器创建命令类
此方法利用 Laravel 内置的 make:command 命令快速生成符合框架规范的命令骨架,确保类结构、命名空间和目录位置完全合规,避免手动创建时因路径或继承问题导致命令不可见。
1、打开终端并切换至 Laravel 项目根目录(即包含 artisan 文件的目录)。
2、执行命令生成新命令类:php artisan make:command SendDailyReport。
3、确认文件已生成于 app/Console/Commands/SendDailyReport.php 路径下。
4、编辑该文件,在 $signature 属性中定义命令名称与参数格式,例如:'report:daily {--force} {email?}'。
5、在 handle() 方法中编写业务逻辑,并使用 $this->info() 或 $this->error() 输出状态信息。
二、通过 Shell 脚本批量生成并标准化命名
该方式适用于团队协作场景,通过外部脚本统一控制命令类命名规则、签名格式及生成路径,规避人工输入错误,提升命令注册一致性与可维护性。
1、在项目根目录新建 scripts/make-command.sh 文件。
2、向文件写入以下内容:#!/bin/bash; php artisan make:command "$1" --command="$2"。
3、赋予脚本执行权限:chmod +x scripts/make-command.sh。
4、运行脚本生成命令:./scripts/make-command.sh ProcessUserImport import:users。
5、验证生成文件 app/Console/Commands/ProcessUserImport.php 中的 $signature 是否为 import:users。
三、手动注册未自动发现的命令类
当命令类置于非标准路径(如 app/Console/Commands/Reports/ 子目录)、使用自定义命名空间或 Laravel 版本低于 8.0 时,框架无法自动加载,必须显式注册到内核中才能出现在 php artisan list 输出中。
1、打开 app/Console/Kernel.php 文件。
2、在 $commands 数组中添加全限定类名:\App\Console\Commands\Reports\SendMonthlyReport::class。
3、若此前修改过目录结构或命名空间,先执行 php artisan config:clear 清除配置缓存。
4、再次运行 php artisan list,确认新命令已列出。
四、在 PHP 运行时动态实例化并执行命令
该方法绕过 Artisan 的命令注册机制,直接在控制器、调度任务或测试环境中调用命令实例的 run() 方法,适用于需条件触发、嵌套调用或规避 CLI 环境限制的场景。
1、确保目标命令类已存在且继承 Illuminate\Console\Command。
2、在调用位置引入必要类:use Symfony\Component\Console\Input\ArrayInput; 和 use Symfony\Component\Console\Output\BufferedOutput;。
3、创建命令实例:$command = new \App\Console\Commands\SendDailyReport();。
4、构造输入与输出对象:$input = new ArrayInput(['--force' => true]); $output = new BufferedOutput();。
5、执行命令:$command->run($input, $output);。
五、基于 Composer Script 封装命令生成流程
将 Artisan 命令生成操作集成进 Composer 的 scripts 配置中,使开发者仅需执行 composer make:command 即可完成全部流程,降低 CLI 使用门槛并统一开发入口。
1、编辑项目根目录下的 composer.json 文件。
2、在 "scripts" 段落中添加:"make:command": "php artisan make:command"。
3、保存后执行:composer run make:command SendEmailsCommand。
4、检查 app/Console/Commands/SendEmailsCommand.php 是否已生成。
5、若需指定命令签名,可在执行时追加参数:-- --command=email:send。


















