• événement
• IntroductionDe nombreuses applications Web exigeront que les utilisateurs vérifient leur adresse e-mail avant utilisation. Plutôt que de vous obliger à l'implémenter à plusieurs reprises dans chaque application, Laravel propose des méthodes pratiques pour envoyer et valider les demandes d'authentification par courrier électronique.
  • Préparation du modèleAvant de commencer, vous devez vérifier si votre modèle AppUser implémente le contrat IlluminateContractsAuthMustVerifyEmail :

  <?php 
      namespace App;
      use Illuminate\Notifications\Notifiable;
      use Illuminate\Contracts\Auth\MustVerifyEmail;
      use Illuminate\Foundation\Auth\User as Authenticatable;
      class User extends Authenticatable implements MustVerifyEmail{ 
         use Notifiable;
         // ...
    }

• Notes sur la base de données

  Champ de vérification de l'e-mail

Ensuite, votre utilisateur doit contenir un champ email_verified_at pour stocker l'heure de l'adresse e-mail vérifiée. Par défaut, la migration des données de la table users dans le framework Laravel inclut déjà ce champ. Donc, tout ce que vous avez à faire est d'effectuer la migration de la base de données :

• php artisan migrate

• routingLa classe AuthVerificationController de Laravel inclut l'envoi des liens de vérification et des e-mails de vérification nécessaires. logique. En passant l'option verify à la méthode Auth::routes, vous pouvez enregistrer les routes requises pour ce contrôleur :

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

Protect Routes

Le middleware d'itinéraire peut être utilisé pour permettre uniquement aux utilisateurs authentifiés d'accéder aux itinéraires spécifiés. Laravel est livré avec le middleware vérifié, qui est défini dans IlluminateAuthMiddlewareEnsureEmailIsVerified. Puisque ce middleware est déjà enregistré auprès du noyau HTTP de votre application, tout ce que vous avez à faire est d'attacher le middleware à la définition de la route :

Route::get('profile', function () { 
   // Only verified users may enter...
 })->middleware('verified');

protected $redirectTo = '/dashboard';

数据库注意事项

Email 验证字段

接下来，你的 user 需要包含一个 email_verified_at 字段用来存储 Email 地址通过验证的时间。默认情况下，Laravel 框架中 users 表的数据迁移已经包含了这个字段。所以，您需要做的就只是执行数据库迁移：

/**
 * 应用程序的事件监听器
 *
 * @var array
 */
 protected $listen = [
     'Illuminate\Auth\Events\Verified' => [   
          'App\Listeners\LogVerifiedUser',   
        ],
  ];

路由

Laravel 的 AuthVerificationController 类包含了发送验证链接和验证 Email 的必要逻辑。通过将 verify 选项传给 Auth::routes 方法，就能为这个控制器注册所需要的路由：

保护路由

路由中间件 可用于仅允许经过验证的用户访问指定路由。Laravel 附带了 verified 中间件，它定义在 IlluminateAuthMiddlewareEnsureEmailIsVerified。由于此中间件已在应用程序的 HTTP 内核中注册，因此您需要做的就是将中间件附加到路由定义：

视图

Laravel 会在你执行  make:auth 命令时为你生成邮件验证所必须的视图文件，视图文件的位置在  resources/views/auth/verify.blade.php，你可以根据自己的应用自由地调整这些视图的样式。

邮箱认证之后

在邮箱认证之后，用户会自动被重定向至 /home。你可通过在 VerificationController 中定义一个 redirectTo 方法或者属性来调整认证之后的跳转位置。

事件

Laravel 可以在验证过程中触发 事件 ， 你应该在 EventServiceProviderLaravel le fera lorsque vous exécuterez la commande make:auth, le fichier de vue nécessaire à la vérification des e-mails sera généré pour vous. L'emplacement du fichier de vue est resources/views/auth/verify.blade.php. Vous Vous êtes libre de personnaliser ces vues en fonction de votre application.