Laravel邮箱验证？验证功能如何添加？

答案：Laravel邮箱验证通过实现MustVerifyEmail接口、添加email_verified_at字段、配置验证路由与中间件、设置邮件服务实现，用户点击签名链接完成验证。

Laravel的邮箱验证功能，说白了，就是给你的用户一个确认身份的机制，确保注册时提供的邮箱是真实有效的。添加这个功能，Laravel其实已经为你铺好了大部分路，你只需要做几步简单的配置和代码调整，就能让它跑起来。核心就是通过发送一个带签名链接的邮件，让用户点击后标记为已验证。

解决方案

在Laravel中添加邮箱验证功能，主要涉及以下几个步骤，它们环环相扣，构成了整个验证流程：

首先，要让你的用户模型知道它需要被验证。这通过实现

IlluminateContractsAuthMustVerifyEmail

接口来完成。打开

app/Models/User.php

文件，修改成这样：

<?phpnamespace AppModels;use IlluminateContractsAuthMustVerifyEmail;use IlluminateDatabaseEloquentFactoriesHasFactory;use IlluminateFoundationAuthUser as Authenticatable;use IlluminateNotificationsNotifiable;use LaravelSanctumHasApiTokens;class User extends Authenticatable implements MustVerifyEmail // 这里是关键{    use HasApiTokens, HasFactory, Notifiable;    // ... 其他属性和方法}

接下来，确保你的

users

表中有一个

email_verified_at

字段。这个字段是用来存储用户邮箱验证成功的时间戳的。如果你是新项目，Laravel自带的

create_users_table

迁移文件里通常已经包含了这个字段。如果不是，你需要手动添加一个迁移：

php artisan make:migration add_email_verified_at_to_users_table --table=users

然后在生成的迁移文件中添加：

// ...public function up(){    Schema::table('users', function (Blueprint $table) {        $table->timestamp('email_verified_at')->nullable()->after('email');    });}public function down(){    Schema::table('users', function (Blueprint $table) {        $table->dropColumn('email_verified_at');    });}// ...

运行

php artisan migrate

来执行迁移。

然后，我们需要告诉Laravel哪些路由需要邮箱验证。最简单的方式是在

routes/web.php

中使用

Auth::routes(['verify' => true])

：

use IlluminateSupportFacadesAuth;Auth::routes(['verify' => true]);Route::get('/home', [AppHttpControllersHomeController::class, 'index'])    ->name('home')    ->middleware('verified'); // 确保只有验证过的用户才能访问

Auth::routes(['verify' => true])

会自动注册所有必要的验证路由，比如发送验证邮件、验证链接处理等。

middleware('verified')

则是一个非常重要的中间件，它会拦截未验证的用户访问特定路由，并将其重定向到验证通知页面。

最后，也是最关键的一步，是配置你的邮件服务。Laravel默认使用

MAIL_MAILER=smtp

，但你需要根据实际情况配置

MAIL_HOST

,

MAIL_PORT

,

MAIL_USERNAME

,

MAIL_PASSWORD

,

MAIL_ENCRYPTION

,

MAIL_FROM_ADDRESS

,

MAIL_FROM_NAME

等

.env

变量。例如，使用 Mailgun 或 SES 会更稳定可靠。

MAIL_MAILER=smtpMAIL_HOST=smtp.mailtrap.io # 生产环境请替换为真实SMTP服务器MAIL_PORT=2525MAIL_USERNAME=null # 替换为你的SMTP用户名MAIL_PASSWORD=null # 替换为你的SMTP密码MAIL_ENCRYPTION=tlsMAIL_FROM_ADDRESS="hello@example.com"MAIL_FROM_NAME="${APP_NAME}"

完成这些步骤后，当用户注册时，Laravel会自动发送一封验证邮件到其注册邮箱。用户点击邮件中的链接后，

email_verified_at

字段就会被填充，用户状态变为已验证。

为什么我的Laravel邮箱验证邮件发不出去？

这是个非常常见的问题，我遇到过不少开发者在邮箱验证功能上线前夕才发现邮件根本发不出去。通常，这背后有几个核心原因，排查起来也有章可循。

首当其冲的，是你的

.env

邮件配置是否正确。我见过太多次，开发者在本地用

MAIL_MAILER=log

或者

array

调试得好好的，一上生产环境就忘了改成真实的 SMTP 配置，或者填错了服务器地址、端口、用户名和密码。

MAIL_HOST

、

MAIL_PORT

、

MAIL_USERNAME

、

MAIL_PASSWORD

这些参数，只要有一个不对，邮件就飞不出去。特别是端口和加密方式（

MAIL_ENCRYPTION

），不同服务商要求可能不同，比如有些是

tls

，有些是

ssl

，端口也可能是

587

或

465

。务必仔细核对你的邮件服务提供商（比如Gmail, Mailgun, SendGrid, AWS SES等）提供的配置信息。

其次，服务器的网络环境也是一个隐形杀手。你的服务器防火墙可能阻止了对外发邮件的端口（通常是

25

,

465

,

587

）。如果你在云服务器上部署，检查一下安全组或防火墙规则，确保这些端口是开放的。有时候，ISP（互联网服务提供商）或者云服务商本身也会限制默认的

25

端口，以防止垃圾邮件。这种情况下，你可能需要换一个端口或者使用一个专用的邮件API服务。

再者，如果你的邮件发送是通过队列（Queue）处理的，那么你得确保队列监听器正在运行。很多时候，为了不阻塞用户请求，Laravel会将邮件发送任务推送到队列中。如果你没有启动

php artisan queue:work

或者

php artisan horizon

，那么这些邮件任务就一直躺在队列里，永远不会被发送出去。检查一下你的

config/queue.php

配置，以及

MAIL_QUEUE_ENABLED

(如果自定义了)等变量。

最后，查看日志文件是解决问题的金钥匙。Laravel会将很多错误信息记录在

storage/logs/laravel.log

文件中。如果邮件发送失败，这里通常会有详细的错误堆栈信息，比如连接超时、认证失败、邮件地址无效等等。仔细阅读这些日志，往往能直接指出问题所在。

当然，还有一些更深层次的问题，比如DNS的SPF和DKIM记录配置不正确，这会导致邮件被标记为垃圾邮件，但通常不会导致邮件完全发不出去，只是收不到。对于生产环境，这些配置也是至关重要的。

如何自定义Laravel邮箱验证通知邮件的样式和内容？

Laravel默认的邮箱验证邮件虽然功能齐全，但样式比较朴素，内容也相对通用。如果你想让验证邮件更符合你的品牌形象，或者添加一些个性化的信息，自定义是完全可行的。

核心思路是覆盖Laravel默认的

VerifyEmail

通知类。Laravel在发送验证邮件时，实际上是触发了一个

IlluminateAuthNotificationsVerifyEmail

通知。你可以通过创建一个自己的通知类来替换它。

首先，在你的

User

模型中，你可以重写

sendEmailVerificationNotification

方法，让它使用你自己的通知类：

// app/Models/User.phpuse AppNotificationsMyVerifyEmail; // 假设你的自定义通知类在这里class User extends Authenticatable implements MustVerifyEmail{    // ...    /**     * Send the email verification notification.     *     * @return void     */    public function sendEmailVerificationNotification()    {        $this->notify(new MyVerifyEmail());    }}

接下来，创建你自己的

MyVerifyEmail

通知类。你可以通过

php artisan make:notification MyVerifyEmail

命令来生成。然后，你需要在这个类中定义

toMail

方法，来构建你的邮件内容。最简单的方式是继承Laravel自带的

VerifyEmail

通知，然后重写

toMail

方法：

// app/Notifications/MyVerifyEmail.phpnamespace AppNotifications;use IlluminateAuthNotificationsVerifyEmail as BaseVerifyEmail;use IlluminateNotificationsMessagesMailMessage;use IlluminateSupportCarbon;use IlluminateSupportFacadesURL;class MyVerifyEmail extends BaseVerifyEmail{    /**     * Get the mail representation of the notification.     *     * @param  mixed  $notifiable     * @return IlluminateNotificationsMessagesMailMessage     */    public function toMail($notifiable)    {        $verificationUrl = $this->verificationUrl($notifiable);        return (new MailMessage)                    ->subject('欢迎来到我们的平台！请验证您的邮箱') // 自定义邮件主题                    ->greeting('您好，' . $notifiable->name . '!') // 自定义问候语                    ->line('感谢您注册我们的服务。为了确保您的账户安全，请点击下方按钮验证您的邮箱地址。') // 自定义邮件正文                    ->action('验证邮箱', $verificationUrl) // 自定义按钮文本和链接                    ->line('如果您没有注册此账户，请忽略此邮件。') // 额外信息                    ->salutation('祝好，' . config('app.name') . '团队'); // 自定义结束语    }    /**     * Get the verification URL for the given notifiable.     *     * @param  mixed  $notifiable     * @return string     */    protected function verificationUrl($notifiable)    {        return URL::temporarySignedRoute(            'verification.verify',            Carbon::now()->addMinutes(config('auth.verification.expire', 60)),            [                'id' => $notifiable->getKey(),                'hash' => sha1($notifiable->getEmailForVerification()),            ]        );    }}

这里我直接复制了

BaseVerifyEmail

中的

verificationUrl

方法，以确保签名链接的生成逻辑不变。你可以在

toMail

方法中尽情发挥，使用

MailMessage

的各种链式方法来构建邮件。

如果你需要更复杂的HTML邮件模板，你可以创建一个

Mailable

类，然后在

toMail

方法中返回这个

Mailable

实例。例如：

// app/Notifications/MyVerifyEmail.php// ...use AppMailCustomVerificationMail; // 你的自定义Mailableclass MyVerifyEmail extends BaseVerifyEmail{    // ...    public function toMail($notifiable)    {        $verificationUrl = $this->verificationUrl($notifiable);        return (new CustomVerificationMail($verificationUrl))                    ->to($notifiable->email);    }}// app/Mail/CustomVerificationMail.phpnamespace AppMail;use IlluminateBusQueueable;use IlluminateContractsQueueShouldQueue;use IlluminateMailMailable;use IlluminateQueueSerializesModels;class CustomVerificationMail extends Mailable{    use Queueable, SerializesModels;    public $verificationUrl;    public function __construct($verificationUrl)    {        $this->verificationUrl = $verificationUrl;    }    public function build()    {        return $this->subject('请验证您的邮箱地址')                    ->markdown('emails.verify-email') // 指向你的Blade模板                    ->with([                        'url' => $this->verificationUrl,                        'userName' => $this->to[0]['name'] ?? '用户', // 假设你可以获取到用户名                    ]);    }}

然后创建一个

resources/views/emails/verify-email.blade.php

模板，用HTML和Blade语法来设计你的邮件。这样就能够完全掌控邮件的视觉呈现了。

在API应用中，Laravel邮箱验证应该如何实现？

在API应用中实现邮箱验证，与传统Web应用有所不同，因为API通常不涉及重定向和Session管理，而是通过JSON响应和Token认证进行交互。核心挑战在于如何处理验证链接的点击，以及如何将验证状态反馈给前端应用。

首先，

MustVerifyEmail

接口和

email_verified_at

字段依然是基础，这些后端逻辑是通用的。

当用户注册后，你可以通过API返回一个成功的响应，并在后台触发邮件发送。邮件内容中包含的验证链接，不应该指向传统的Web路由，而应该指向一个专门用于API验证的端点。

假设你的前端应用是一个SPA (Single Page Application) 或移动应用：

修改验证链接的生成逻辑：在

User

模型中，或者你自定义的

MyVerifyEmail

通知类中，你需要修改

verificationUrl

方法，使其生成的链接指向你的前端应用的一个特定路由，并且这个路由会带上Laravel生成的签名验证参数。

例如，如果你的前端验证页面是

https://your-frontend.com/verify-email?signature=...&expires=...&id=...&hash=...

，那么在通知类中可以这样生成：

// app/Notifications/MyVerifyEmail.php// ...protected function verificationUrl($notifiable){    // 假设你的前端验证页面URL    $frontendVerificationUrl = config('app.frontend_url') . '/verify-email';    return URL::temporarySignedRoute(        'verification.verify.api', // 这是一个你自定义的API验证路由名称        Carbon::now()->addMinutes(config('auth.verification.expire', 60)),        [            'id' => $notifiable->getKey(),            'hash' => sha1($notifiable->getEmailForVerification()),            'redirect' => $frontendVerificationUrl, // 将前端URL作为参数传递        ]    );}

这里

config('app.frontend_url')

是你在

.env

中定义的前端应用的基URL。

创建API验证路由和控制器：在

routes/api.php

中定义一个用于处理验证链接的路由。这个路由会接收到签名参数，并进行验证。

// routes/api.phpuse IlluminateSupportFacadesRoute;use AppHttpControllersApiEmailVerificationController;Route::get('/email/verify/{id}/{hash}', [EmailVerificationController::class, 'verify'])    ->middleware(['auth:sanctum', 'signed']) // 使用 'signed' 中间件验证URL签名    ->name('verification.verify.api');Route::post('/email/resend', [EmailVerificationController::class, 'resend'])    ->middleware(['auth:sanctum', 'throttle:6,1'])    ->name('verification.resend.api');

注意这里的

auth:sanctum

和

signed

中间件。

signed

中间件会检查URL的签名是否有效且未过期。

实现API验证控制器：在

app/Http/Controllers/Api/EmailVerificationController.php

中，你需要编写

verify

方法来处理实际的验证逻辑。

// app/Http/Controllers/Api/EmailVerificationController.phpnamespace AppHttpControllersApi;use AppHttpControllersController;use IlluminateHttpRequest;use AppModelsUser;use IlluminateAuthEventsVerified;use IlluminateAuthAccessAuthorizationException;class EmailVerificationController extends Controller{    public function verify(Request $request, User $user)    {        // 检查URL的ID和哈希是否匹配        if (! hash_equals((string) $request->route('id'), (string) $user->getKey())) {            throw new AuthorizationException;        }        if (! hash_equals((string) $request->route('hash'), sha1($user->getEmailForVerification()))) {            throw new AuthorizationException;        }        // 检查用户是否已经验证过        if ($user->hasVerifiedEmail()) {            // 如果已经验证，可以返回一个成功响应，或者重定向到前端的某个页面            return response()->json(['message' => 'Email already verified.'], 200);        }        // 执行验证        if ($user->markEmailAsVerified()) {            event(new Verified($user));        }        // 验证成功，返回JSON响应        return response()->json(['message' => 'Email verified successfully.'], 200);    }    public function resend(Request $request)    {        $user = $request->user();        if ($user->hasVerifiedEmail()) {            return response()->json(['message' => 'Email already verified.'], 400);        }        $user->sendEmailVerificationNotification();        return response()->json(['message' => 'Verification link resent.'], 200);    }}

这里，当用户点击邮件中的链接时，请求会打到这个

verify

API端点。前端应用在收到邮件后，用户点击链接，如果这个链接被配置为打开前端应用的某个页面，那么前端应用需要解析URL参数（

id

,

hash

,

signature

等），然后将这些参数通过API请求（比如一个GET请求）发送到

verification.verify.api

这个后端路由。后端处理验证逻辑，然后返回JSON响应给前端。前端根据JSON响应来更新UI，比如显示“验证成功”或“验证失败”。

前端处理：前端应用需要有一个专门的页面或组件来处理验证链接。当用户点击邮件中的链接，如果链接指向前端应用，前端需要：

解析URL中的

id

,

hash

,

signature

等参数。将这些参数发送到后端的

verification.verify.api

端点。根据后端返回的JSON响应，显示验证结果。如果验证成功，可能需要提示用户登录或自动登录（如果前端可以处理Token）。

这种方式将验证逻辑完全放在后端API中，前端只负责触发和展示结果，保持了前后端分离的原则。

以上就是Laravel邮箱验证？验证功能如何添加？的详细内容，更多请关注php中文网其它相关文章！