Laravel 9.x 中文文档

简体中文

English

简体中文

English

主题

邮件验证 ​

介绍 ​

许多网络应用程序要求用户在使用应用程序之前验证他们的电子邮件地址。Laravel 提供了方便的内置服务来发送和验证电子邮件验证请求，而不是让您为每个应用程序手动重新实现此功能。

lightbulb

想快速开始吗？在新的 Laravel 应用程序中安装一个 Laravel 应用程序入门套件。入门套件将负责搭建整个身份验证系统，包括电子邮件验证支持。

模型准备 ​

在开始之前，请验证您的 App\Models\User 模型是否实现了 Illuminate\Contracts\Auth\MustVerifyEmail 合约：

php
<?php

namespace App\Models;

use Illuminate\Contracts\Auth\MustVerifyEmail;
use Illuminate\Foundation\Auth\User as Authenticatable;
use Illuminate\Notifications\Notifiable;

class User extends Authenticatable implements MustVerifyEmail
{
    use Notifiable;

    // ...
}

一旦将此接口添加到您的模型中，新注册的用户将自动收到包含电子邮件验证链接的电子邮件。通过检查应用程序的 App\Providers\EventServiceProvider，您可以看到 Laravel 已经包含了一个 SendEmailVerificationNotification 监听器，该监听器附加到 Illuminate\Auth\Events\Registered 事件。此事件监听器将向用户发送电子邮件验证链接。

如果您在应用程序中手动实现注册而不是使用 入门套件，您应该确保在用户注册成功后调度 Illuminate\Auth\Events\Registered 事件：

php
use Illuminate\Auth\Events\Registered;

event(new Registered($user));

数据库准备 ​

接下来，您的 users 表必须包含一个 email_verified_at 列，以存储用户电子邮件地址验证的日期和时间。默认情况下，Laravel 框架附带的 users 表迁移已经包含此列。因此，您只需运行数据库迁移：

shell
php artisan migrate

路由 ​

要正确实现电子邮件验证，需要定义三个路由。首先，需要一个路由来向用户显示通知，告知他们应点击注册后 Laravel 发送的验证邮件中的电子邮件验证链接。

其次，需要一个路由来处理用户点击电子邮件中的验证链接时生成的请求。

第三，需要一个路由来重新发送验证链接，以防用户意外丢失第一个验证链接。

邮件验证通知 ​

如前所述，应定义一个路由，该路由将返回一个视图，指示用户点击注册后由 Laravel 通过电子邮件发送给他们的电子邮件验证链接。当用户尝试访问应用程序的其他部分而未先验证其电子邮件地址时，将向他们显示此视图。请记住，只要您的 App\Models\User 模型实现了 MustVerifyEmail 接口，链接就会自动通过电子邮件发送给用户：

php
Route::get('/email/verify', function () {
    return view('auth.verify-email');
})->middleware('auth')->name('verification.notice');

返回电子邮件验证通知的路由应命名为 verification.notice。重要的是，该路由被分配了这个确切的名称，因为如果用户尚未验证其电子邮件地址，Laravel 包含的 verified 中间件将自动重定向到此路由名称。

lightbulb

在手动实现电子邮件验证时，您需要自己定义验证通知视图的内容。如果您希望包含所有必要身份验证和验证视图的脚手架，请查看 Laravel 应用程序入门套件。

邮件验证处理程序 ​

接下来，我们需要定义一个路由来处理用户点击电子邮件中验证链接时生成的请求。此路由应命名为 verification.verify 并分配 auth 和 signed 中间件：

php
use Illuminate\Foundation\Auth\EmailVerificationRequest;

Route::get('/email/verify/{id}/{hash}', function (EmailVerificationRequest $request) {
    $request->fulfill();

    return redirect('/home');
})->middleware(['auth', 'signed'])->name('verification.verify');

在继续之前，让我们仔细看看这个路由。首先，您会注意到我们使用的是 EmailVerificationRequest 请求类型，而不是典型的 Illuminate\Http\Request 实例。EmailVerificationRequest 是 Laravel 附带的 表单请求。此请求将自动负责验证请求的 id 和 hash 参数。

接下来，我们可以直接调用请求的 fulfill 方法。此方法将调用经过身份验证的用户的 markEmailAsVerified 方法并调度 Illuminate\Auth\Events\Verified 事件。markEmailAsVerified 方法通过 Illuminate\Foundation\Auth\User 基类可用于默认的 App\Models\User 模型。一旦用户的电子邮件地址被验证，您可以将他们重定向到您希望的任何地方。

重新发送验证邮件 ​

有时用户可能会丢失或意外删除电子邮件地址验证邮件。为此，您可能希望定义一个路由，以允许用户请求重新发送验证邮件。然后，您可以通过在 验证通知视图 中放置一个简单的表单提交按钮来请求此路由：

php
use Illuminate\Http\Request;

Route::post('/email/verification-notification', function (Request $request) {
    $request->user()->sendEmailVerificationNotification();

    return back()->with('message', 'Verification link sent!');
})->middleware(['auth', 'throttle:6,1'])->name('verification.send');

保护路由 ​

路由中间件 可用于仅允许经过验证的用户访问给定路由。Laravel 附带一个 verified 中间件，该中间件引用 Illuminate\Auth\Middleware\EnsureEmailIsVerified 类。由于此中间件已在应用程序的 HTTP 内核中注册，您只需将中间件附加到路由定义即可。通常，此中间件与 auth 中间件配对：

php
Route::get('/profile', function () {
    // 只有经过验证的用户才能访问此路由...
})->middleware(['auth', 'verified']);

如果未经验证的用户尝试访问已分配此中间件的路由，他们将自动重定向到 verification.notice 命名路由。

自定义 ​

验证邮件自定义 ​

尽管默认的电子邮件验证通知应该满足大多数应用程序的要求，但 Laravel 允许您自定义电子邮件验证邮件消息的构建方式。

要开始，请将闭包传递给 Illuminate\Auth\Notifications\VerifyEmail 通知提供的 toMailUsing 方法。闭包将接收接收通知的可通知模型实例以及用户必须访问以验证其电子邮件地址的签名电子邮件验证 URL。闭包应返回 Illuminate\Notifications\Messages\MailMessage 的实例。通常，您应该从应用程序的 App\Providers\AuthServiceProvider 类的 boot 方法中调用 toMailUsing 方法：

php
use Illuminate\Auth\Notifications\VerifyEmail;
use Illuminate\Notifications\Messages\MailMessage;

/**
 * 注册任何身份验证/授权服务。
 *
 * @return void
 */
public function boot()
{
    // ...

    VerifyEmail::toMailUsing(function ($notifiable, $url) {
        return (new MailMessage)
            ->subject('验证电子邮件地址')
            ->line('点击下面的按钮以验证您的电子邮件地址。')
            ->action('验证电子邮件地址', $url);
    });
}
lightbulb

要了解有关邮件通知的更多信息，请查阅 邮件通知文档。

事件 ​

使用 Laravel 应用程序入门套件 时，Laravel 在电子邮件验证过程中调度 事件。如果您在应用程序中手动处理电子邮件验证，您可能希望在验证完成后手动调度这些事件。您可以在应用程序的 EventServiceProvider 中附加这些事件的监听器：

php
use App\Listeners\LogVerifiedUser;
use Illuminate\Auth\Events\Verified;

/**
 * 应用程序的事件监听器映射。
 *
 * @var array
 */
protected $listen = [
    Verified::class => [
        LogVerifiedUser::class,
    ],
];

版权所有 © 2024-2025 laravel.wiki