php artisan queue 基础教程：一步步教你处理后台耗时任务！

发布日期： 2025-10-04 阅读量： 作者： admin

今天想跟大家唠唠 Laravel 里的队列，就是那个 php artisan queue 的玩意儿。我自个儿捣鼓这东西也有一段时间了，确实帮我解决了不少头疼的问题，所以分享下我的实践过程。

为啥要用队列？

刚开始做项目的时候，有些操作特别慢，比如用户注册完要发个欢迎邮件，或者用户上传了个大文件需要后台处理、生成个报表啥的。这些事儿，你要是放请求里直接处理，那用户就得在那儿干等着，浏览器一直转圈圈，体验贼差。有时候甚至搞得服务器都卡死，或者 PHP 执行超时报错。这肯定不行，得想办法优化。

后来就知道了 Laravel 队列这东西，它可以把这些耗时间的任务扔到后台慢慢做，先把用户的请求响应了，告诉用户“行了，我收到你的请求了，正在处理”，这样用户体验就好了很多。

开始动手搞队列

第一步：配置

得先告诉 Laravel 你想用哪种方式来处理队列。打开项目根目录下的 .env 文件，找到 QUEUE_CONNECTION 这个配置项。默认好像是 sync，这个 sync 驱动，就是同步执行，跟没用队列差不多，主要是方便本地开发调试。真要异步处理，就得换别的。

我一开始图省事，直接用了 database 驱动。为因为它依赖少，只要你有数据库就行，不用额外装 Redis 什么的。后来项目大了，并发高了，还是换成了 redis，性能确实猛。不过刚开始用 database 完全够，学习成本低。

选了 database 驱动后，还需要创建存放队列任务的数据库表。Laravel 都帮你准备好了，直接在项目根目录运行两条命令：

php artisan queue:table 这条命令会在 database/migrations 目录下生成一个创建 jobs 表的迁移文件。
php artisan migrate 运行迁移，就在数据库里创建了这张表。

这样，基础配置就算搞定了。

第二步：创建任务（Job）

接下来就得定义具体要干啥活儿了。比如我要在用户注册后发邮件，那我就创建一个“发送邮件”的任务。用 Artisan 命令很方便：

php artisan make:job SendWelcomeEmail

执行完，Laravel 会在 app/Jobs 目录下生成一个文件。打开这个文件，核心就是那个 handle() 方法。你所有耗时的逻辑，比如连接邮件服务器、发送邮件的代码，就都写在这个 handle() 方法里面。

如果你的任务需要一些数据，比如给哪个用户发邮件，可以通过构造函数传进来。像这样：


// 在 * 里面
protected $user;
public function __construct($user)

$this->user = $user;

public function handle()

// 这里写真正发邮件的代码
// 可以用 $this->user->email 获取邮箱地址
// ... 发送邮件 ...

第三步：分发任务

任务定义好了，总得在需要的时候把它扔到队列里去。这个操作叫“分发任务”。在你原来的代码里，比如用户注册成功的地方，不再直接调用发送邮件的函数，而是改成这样：

App\Jobs\SendWelcomeEmail::dispatch($user);

这里的 $user 就是你查出来的用户信息，传给任务的构造函数。执行这行代码非常快，它只是把任务信息（包括任务类名、需要的数据等）序列化一下，存到你配置的队列驱动（比如数据库的 jobs 表）里，然后请求就结束了，用户立马就能看到注册成功的页面。

第四步：运行队列处理器（Worker）

任务是扔进队列了，但它不会自己执行。你需要启动一个“工人”（Worker）进程，这个工人专门负责从队列里取出任务，然后执行任务类里的 handle() 方法。

在你的服务器或者开发环境的命令行里，进入项目根目录，运行：

php artisan queue:work

运行之后，这个命令会一直挂起，监听队列。一旦有新的任务进来，它就会取出来执行。你会看到类似“Processing: App\Jobs\SendWelcomeEmail”和“Processed: App\Jobs\SendWelcomeEmail”这样的输出。

这里有个坑要注意： 你直接在命令行运行 queue:work，只要你关掉这个命令行窗口，或者 SSH 连接断了，这个工人就停了，队列里的任务就没人处理了。所以在正式服务器上，不能这么干。

通常我们会用 Supervisor 这样的进程管理工具来管理 php artisan queue:work 命令。Supervisor 能保证这个命令一直在后台运行，万一挂了还能自动重启。配置 Supervisor 可能稍微麻烦点，但这是保证队列稳定运行的关键一步，网上教程很多，照着做就行。

处理失败的任务

有时候任务可能会执行失败，比如邮件服务器突然连不上了。默认情况下，Laravel 会尝试执行几次（可以在 Job 类里设置 $tries 属性），如果最终还是失败了，它会把这个失败的任务记录到一个专门的表里（如果你用 database 驱动，需要先运行 php artisan queue:failed-table 和 php artisan migrate 创建 failed_jobs 表）。

你可以用 php artisan queue:failed 查看所有失败的任务，用 php artisan queue:retry [任务ID或all] 来手动重试这些失败的任务。

效果

搞完这一套之后，效果还是很明显的。原来那些慢吞吞的操作，现在用户那边几乎感觉不到延迟了。应用响应速度快了很多，服务器压力也小了，因为把重活儿都挪到后台异步处理了。虽然一开始配置 Supervisor 什么的稍微费了点劲，但后面用起来是真的香。

Laravel 这个队列系统做得挺完善的，从配置到使用都比较顺手。如果你项目里也有类似的耗时任务场景，强烈建议试试看 php artisan queue，对提升应用性能和用户体验帮助很大。

上一篇: 东莞商务调查公司靠谱吗？业内人士揭秘行业内幕！

php artisan queue 基础教程：一步步教你处理后台耗时任务！

随便看看