Laravel 命令速查表 - Laravel Artisan 常用命令大全

这套速查给用 Laravel 做业务系统、以及负责部署的开发者,核心是每天都敲的 Artisan 命令行。它覆盖建项目、生成 controller/model/migration、跑与回滚迁移、用 route/config/view 缓存把线上性能提上去,以及用队列把重活丢到后台。与一条条堆 artisan 命令不同,条目按"建功能→迁库→本地联调→上线前缓存→队列化重活"的真实节奏排布。读完应能快速搭出一个 CRUD 功能并顺畅迁移库,同时心里清楚每一条缓存命令到底落地了什么、清了什么。

编程语言·共 40 条命令·最后更新 2026-07-21
laravelphpframework

项目与开发 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日,内容持续校对官方文档。

联系我们

命令或描述有误?提交反馈、商务合作或产品建议都可发送邮件给我们。

联系我们