Laravel 验证码认证学习记录小结

注：此处所用的注册等系列功能，均作用于 laravel 自带的用户认证机制

注册验证码

1. composer 安装验证码

composer require "mews/captcha:~3.0"

2. 运行以下命令生成配置文件 config/captcha.php

php artisan vendor:publish --provider='Mews.aptcha.aptchaServiceProvider'

3. 前端展示验证码

<img class="thumbnail captcha mt-3 mb-2" src="{{%20captcha_src('flat')%20}}" onclick="this.src='/captcha/flat?'+Math.random()" title="点击图片重新获取验证码">

4. 后端验证（该扩展包是为 Laravel 定制的扩展包，完全兼容 laravel 注册功能，验证非常方便）只需要在 app/Http/Controllers/Auth/RegisterController.php 中的验证规则中加入如下代码：

 'captcha' => ['required', 'captcha'],

邮箱认证

laravel 自带邮箱认证

laravel 自带的邮箱认证文件位于 vendor/laravel/framework/src/Illuminate/Auth/MustVerifyEmail.php ，因为此文件采用 trait 声明，因此我们快速的将内容通过 use 集成到用户的模型中，并进行调用，如下：

  namespace App\Models;
  use Illuminate\Foundation\Auth\User as Authenticatable;
  use Illuminate\Notifications\Notifiable;
  use Illuminate\Auth\MustVerifyEmail as MustVerifyEmailTrait;
  class User extends Authenticatable {
    use Notifiable, MustVerifyEmailTrait;

为了代码的规范，我们可以接入 larave 自带的邮箱验证接口 Illuminate\Contracts\Auth\MustVerifyEmail，规定模型必须拥有相关的方法，具体方法如下（方法在 MustVerifyEmailTrait 中已经定义好，直接调用既可）：

hasVerifiedEmail() 检测用户 Email 是否已认证；
markEmailAsVerified() 将用户标示为已认证；
sendEmailVerificationNotification() 发送 Email 认证的消息通知，触发邮件的发送；
getEmailForVerification() 获取发送邮件地址，提供这个接口允许你自定义邮箱字段。

发送邮件

我们使用了 Laravel 自带的 RegisterController ，控制器通过加载 Illuminate.oundation.uth.egistersUsers trait 来引入框架的注册功能，此时我们打开此 trait 来翻阅源码并定位到 register(Request $request) 方法：

public function register(Request $request) { 
// 检验用户提交的数据是否有误 
$this->validator($request->all())->validate(); 
// 创建用户同时触发用户注册成功的事件，并将用户传参 
event(new Registered($user = $this->create($request->all()))); 
// 登录用户 
$this->guard()->login($user); 
// 调用钩子方法`registered()`
return $this->registered($request, $user) ?: redirect($this->redirectPath()); 
}

此方法处理了用户提交表单后的逻辑，我们把重点放在 event(new Registered($user = $this->create($request->all())));，这里使用了 Laravel 的事件系统，触发了 Registered 事件。

打开 app/Providers/EventServiceProvider.php 文件，此文件的 $listen 属性里我们可以看到注册了 Registered 事件的监听器：

protected $listen = [ 
  Registered::class => [ SendEmailVerificationNotification::class, ], 
];

打开 SendEmailVerificationNotification 类，阅读其源码：vendor/laravel/framework/src/Illuminate/Auth/Listeners/SendEmailVerificationNotification.php

<?php 
namespace Illuminate\Auth\Listeners;

use Illuminate\Auth\Events\Registered;
use Illuminate\Contracts\Auth\MustVerifyEmail;

class SendEmailVerificationNotification
{
  /**
   * 处理事件
   *
   * @param \Illuminate\Auth\Events\Registered $event
   * @return void
   */
  public function handle(Registered $event)
  {
    // 如果 user 是继承于 MustVerifyEmail 并且还未激活的话
    if ($event->user instanceof MustVerifyEmail && ! $event->user->hasVerifiedEmail()) {
      // 发送邮件认证消息通知（认证邮件）
      $event->user->sendEmailVerificationNotification();
    }
  }
}

可以看出 Laravel 默认已经为我们设置了邮件发送的逻辑，接下来我们来测试一下。

测试邮件

测试之前，我们先设置下邮件发送到 log 中，以便后面的测试：

修改环境设置文件.env