29 使用队列发送邮件

在上一篇教程中，我们介绍了如何使用 Laravel 发送文本邮件，并展示了基本的邮件发送功能。这一次，我们将进一步探讨如何使用队列发送邮件，以提高系统的性能和用户体验。通过将邮件发送任务放置到队列中，我们能够减少用户等待时间，同时使得邮件发送变得更加灵活与高效。

什么是队列？

队列是一种异步处理机制，可以将耗时的操作（如发送邮件、处理图片等）推送到后台进行处理，而不是在当前请求中立即执行。这种方式可以有效地提升应用的响应速度，让用户能够更快地获得反馈。

使用队列发送邮件的好处

• 提升响应速度：用户请求后，邮件发送任务被丢入队列，用户不需要等待邮件发送完毕。
• 减轻服务器负担：特别是在发送大量邮件时，使用队列能够分摊负载。
• 任务重试机制：如果邮件发送失败，队列可以自动重试，保证邮件发送的可靠性。

设置队列

在开始发送队列邮件之前，我们需要确保 Laravel 的队列系统已经配置好。在 Laravel 中，可以使用多种队列驱动，比如 database、redis 等。我们将以 database 驱动为例进行讲解。

1. 数据库迁移

首先，确保你的数据库中有一个队列表。你可以运行以下 Artisan 命令来生成迁移文件：

php artisan queue:table

然后执行迁移：

php artisan migrate

2. 配置队列

在 config/queue.php 文件中，确保 default 设置为 database：

'default' => env('QUEUE_CONNECTION', 'database'),

同时在 .env 文件中确认队列连接：

QUEUE_CONNECTION=database

3. 创建邮件类

在发送邮件之前，我们需要一个邮件类。你可以使用以下命令创建一个新的邮件类：

php artisan make:mail SendDemoMail

在生成的 app/Mail/SendDemoMail.php 文件中，你可以定义邮件内容。例如：

namespace App\Mail;

use Illuminate\Bus\Queueable;
use Illuminate\Mail\Mailable;
use Illuminate\Queue\SerializesModels;

class SendDemoMail extends Mailable
{
    use Queueable, SerializesModels;

    public $data;

    public function __construct($data)
    {
        $this->data = $data;
    }

    public function build()
    {
        return $this->subject('测试邮件')->view('emails.demo')->with('data', $this->data);
    }
}

4. 创建发送邮件的任务

接下来我们需要创建一个发送邮件的任务。使用以下命令创建任务类：

php artisan make:job SendEmailJob

在 app/Jobs/SendEmailJob.php 文件中修改类，使其能够发送邮件：

namespace App\Jobs;

use App\Mail\SendDemoMail;
use Illuminate\Bus\Queueable;
use Illuminate\Contracts\Queue\ShouldQueue;
use Illuminate\Foundation\Bus\Dispatchable;
use Illuminate\Support\Facades\Mail;
use Illuminate\Queue\SerializesModels;

class SendEmailJob implements ShouldQueue
{
    use Dispatchable, Queueable, SerializesModels;

    protected $data;

    public function __construct($data)
    {
        $this->data = $data;
    }

    public function handle()
    {
        Mail::to($this->data['email'])->send(new SendDemoMail($this->data));
    }
}

5. 调用队列任务发送邮件

在你的控制器中，你可以调用这个邮件发送任务并将其推送到队列中：

namespace App\Http\Controllers;

use App\Jobs\SendEmailJob;
use Illuminate\Http\Request;

class MailController extends Controller
{
    public function send(Request $request)
    {
        $data = [
            'email' => $request->input('email'),
            'name' => $request->input('name'),
        ];
        
        // 使用队列发送邮件
        SendEmailJob::dispatch($data);

        return response()->json(['message' => '邮件发送成功，正在处理中...']);
    }
}

6. 启动队列处理

为了让队列能够正常运行，你需要启动队列处理器。在命令行中运行：

php artisan queue:work

此时，所有在队列中等待的邮件任务将会被处理。一旦邮件发送成功，用户将不会感觉到延迟，体验将更加流畅。

总结

在本节教程中，我们详细讲解了如何在 Laravel 中使用队列发送邮件。通过将邮件发送的业务逻辑放入队列中处理，我们提升了系统的性能与用户体验。接下来，我们将学习如何使用邮件模板来丰富邮件内容，从而提升邮件的展示效果。

继续关注我们的系列教程，了解更多 Laravel 的强大功能！