Laravel队列怎么使用_Laravel队列配置任务调度及异步处理实战教程

Laravel队列通过异步处理耗时任务提升性能，支持多种驱动如Redis、database，配置QUEUE_CONNECTION=redis并安装predis，使用php artisan make:job创建任务类，在handle中执行逻辑，通过dispatch分发任务可设置延迟或指定队列，运行php artisan queue:work启动监听器，结合supervisor守护进程，利用schedule:run实现定时任务调度，实战中可用于异步导出数据并邮件通知，注意传递模型ID而非实例、设置超时与重试次数，推荐生产环境使用Redis+Horizon进行监控管理。

在Laravel中，队列系统是处理耗时任务、提升应用响应速度的核心工具。通过将邮件发送、文件处理、API调用等任务推入队列异步执行，可以显著改善用户体验。结合任务调度，还能实现定时自动化操作。下面带你一步步掌握Laravel队列的配置、使用与实战技巧。

配置队列驱动

Laravel支持多种队列驱动：sync（同步）、database、redis、beanstalkd、sqs等。开发阶段常用database或redis，生产环境推荐Redis以获得高性能。

修改.env文件设置默认驱动：

QUEUE_CONNECTION=redis

确保已安装Predis扩展：

composer require predis/predis

若使用database驱动，需生成数据表：

php artisan queue:table
php artisan migrate

创建队列任务类

使用Artisan命令创建一个可排队的任务：

php artisan make:job SendWelcomeEmail

生成的类位于app/Jobs/SendWelcomeEmail.php。编辑其handle方法：

public function handle()
{
    // 模拟耗时操作
    sleep(5);
    \Log::info('欢迎邮件已发送给: ' . $this->user->email);
}

构造函数接收参数并保存为属性，以便handle方法使用。

分发任务到队列

在控制器或路由中调用任务：

use App\Jobs\SendWelcomeEmail;
// 推送任务进队列
SendWelcomeEmail::dispatch($user);

也可以指定延迟执行：

SendWelcomeEmail::dispatch($user)->delay(now()->addMinutes(10));

或指定队列名称：

SendWelcomeEmail::dispatch($user)->onQueue('emails');

运行队列监听器

启动队列处理器：

php artisan queue:work

该命令会持续监听队列并处理任务。建议配合supervisor管理进程，防止意外退出。

查看失败任务：

php artisan queue:failed

重试失败任务：

php artisan queue:retry all

清除失败任务：

php artisan queue:flush

结合任务调度实现定时队列

Laravel的调度器允许你定义定时任务，比如每天凌晨清理日志。

打开app/Console/Kernel.php，在schedule方法中添加：

$schedule->job(new CleanupLogsJob)->daily();

或者调度闭包任务：

$schedule->call(function () {
    dispatch(new GenerateReportJob);
})->weekly();

然后在服务器的crontab中添加一行：

* * * * * cd /path-to-your-project && php artisan schedule:run >> /dev/null 2>&1

实战场景：异步导出用户数据

假设需要导出大量用户数据为CSV文件：

用户点击“导出”按钮，立即返回“任务已提交”
后台队列任务生成CSV并发送邮件通知下载链接

控制器代码：

public function export()
{
    ExportUserListJob::dispatch(auth()->user());
    return response()->json(['message' => '导出任务已加入队列']);
}

任务类中使用 Laravel Excel 或原生文件操作生成文件，并通过Mail门面发送通知。

优化建议与注意事项

队列使用过程中注意以下几点：

避免在任务中传递Eloquent模型，应只传ID，在handle中重新查询
设置合理的超时时间（--timeout）和最大尝试次数（--tries）
使用Redis时注意连接稳定性和内存占用
开启队列失败日志便于排查问题

基本上就这些。Laravel队列 + 调度器组合非常强大，合理使用能让应用更高效稳定。实际项目中建议搭配Horizon（Redis监控面板）进行可视化管理。不复杂但容易忽略细节，比如模型序列化问题和进程守护配置。

# php # excel # laravel # redis # js # json # composer # 处理器 # app # 工具 # csv # 构造函数 # mail # 闭包 # 并发 # console # 异步 # database # 自动化 # 重试 # 还能 # 能让 # 几点 # 而非 # 高性能 # 带你 # 下载链接 # 创建一个 # 发送邮件

返回目录在线咨询

上一篇：微信小程序之蓝牙的链接
下一篇：图片优化如何提升网站流量_SEO优化教程

您的项目需求

*请认真填写需求信息，我们会在24小时内与您取得联系。

全网整合营销服务商