Laravel 命令速查表 - Laravel Artisan 常用命令大全
这套速查给用 Laravel 做业务系统、以及负责部署的开发者,核心是每天都敲的 Artisan 命令行。它覆盖建项目、生成 controller/model/migration、跑与回滚迁移、用 route/config/view 缓存把线上性能提上去,以及用队列把重活丢到后台。与一条条堆 artisan 命令不同,条目按"建功能→迁库→本地联调→上线前缓存→队列化重活"的真实节奏排布。读完应能快速搭出一个 CRUD 功能并顺畅迁移库,同时心里清楚每一条缓存命令到底落地了什么、清了什么。
项目与开发 10
laravel new project创建新项目
php artisan serve启动开发服务器
php artisan make:model Post -mcr创建模型+迁移+控制器
php artisan make:migration create_posts_table创建迁移文件
php artisan make:controller PostController创建控制器
php artisan make:middleware CheckAge创建中间件
php artisan make:request StorePostRequest创建表单请求
php artisan make:job ProcessPodcast创建队列任务
php artisan make:event PodcastProcessed创建事件
php artisan make:listener SendNotification创建监听器
数据库 8
php artisan migrate执行所有未跑过的迁移,把表结构变更落到数据库
php artisan migrate:fresh先回滚全部迁移再重新跑一遍,等于重建库表,开发/测试环境可快速重置数据
php artisan migrate:rollback回退最近一批迁移(一批默认是 recent 组),改错表结构直接回到上一步
php artisan migrate:status列出每条迁移的 pending/ran 状态,排查为什么某张表没建出来
php artisan db:seed运行数据库种子填充,给开发环境灌入测试数据
php artisan db:seed --class=UserSeeder只执行指定的 seeder 类,而不是全量跑一遍
php artisan make:seeder UserSeeder生成一个 seeder 类模板,到里面写具体要插入的数据
php artisan make:factory PostFactory生成测试工厂,配合 faker 批量制造假模型数据
路由与缓存 9
php artisan route:list列出应用全部路由及对应控制器方法,排查 404/405 或重复路由很直观
php artisan route:cache把路由编译为缓存文件,缩短每请求解析开销,生产环境部署后跑一次
php artisan route:clear删除路由缓存,改了路由又看到旧行为时先清它
php artisan config:cache把全部配置烘焙为单个缓存文件,显著降低每请求读配置的开销
php artisan config:clear删除配置缓存,改完 .env 后务必清,否则新配置不生效
php artisan view:cache预编译全部 blade 视图模板,省去每次渲染的编译步骤
php artisan view:clear清除已编译的视图缓存,模板改动异常时先清它
php artisan optimize一次完成配置与路由等缓存,适合上线前的性能收尾
php artisan optimize:clear一并清空前面落地的全部缓存,回滚线上改动或恢复调试时用它
队列与任务 7
php artisan queue:work启动一个常驻队列 worker,持续消费队列任务,生产由进程管理守护
php artisan queue:work --queue=high,default按优先级顺序消费,先处理 high 队列再退到 default,让重要任务先落地
php artisan queue:restart优雅地让所有在跑 worker 在处理完当前任务后重启以加载新代码
php artisan queue:failed列出处理失败的任务及其原因,通常配合日志排查
php artisan queue:retry <id>把指定失败任务重新丢回队列重试,修好逻辑后临时救场
php artisan queue:flush清空所有失败任务记录,确认无需重试后清理堆积
php artisan make:job ProcessPodcast生成队列任务类骨架,在 handle() 里写真正要异步执行的逻辑
测试与调试 6
php artisan test运行测试
php artisan test --filter=UserTest运行指定测试
php artisan tinker进入交互式 REPL
php artisan down进入维护模式
php artisan up退出维护模式
php artisan storage:link创建 storage 软链接
提示
- 生产环境务必执行 php artisan optimize 缓存配置和路由。
- make:model -mcr 一次性生成模型+迁移+资源控制器,节省时间。
- 队列 worker 用 Supervisor 守护,避免进程意外退出。
由 巧匠 维护
公开更新于 2026年7月21日,内容持续校对官方文档。