Send an event when the user's email is verified

Upon user email verification we may like to take certain immediate actions. For example, once we have verified that the user has a valid email from a certain company domain, we may assign a role automatically.

src/Illuminate/Auth/Events/Verified.php

@@ -0,0 +1,28 @@
+<?php
+
+namespace Illuminate\Auth\Events;
+
+use Illuminate\Queue\SerializesModels;
+
+class Verified
+{
+    use SerializesModels;
+
+    /**
+     * The verified user.
+     *
+     * @var \Illuminate\Contracts\Auth\MustVerifyEmail
+     */
+    public $user;
+
+    /**
+     * Create a new event instance.
+     *
+     * @param  \Illuminate\Contracts\Auth\MustVerifyEmail  $user
+     * @return void
+     */
+    public function __construct($user)
+    {
+        $this->user = $user;
+    }
+}

src/Illuminate/Auth/MustVerifyEmail.php

@@ -17,11 +17,11 @@ public function hasVerifiedEmail()
     /**
      * Mark the given user's email as verified.
      *
-     * @return void
+     * @return bool
      */
     public function markEmailAsVerified()
     {
-        $this->forceFill(['email_verified_at' => $this->freshTimestamp()])->save();
+        return $this->forceFill(['email_verified_at' => $this->freshTimestamp()])->save();
     }
 
     /**

src/Illuminate/Foundation/Auth/VerifiesEmails.php

@@ -2,6 +2,7 @@
 
 namespace Illuminate\Foundation\Auth;
 
+use Illuminate\Auth\Events\Verified;
 use Illuminate\Http\Request;
 
 trait VerifiesEmails
@@ -30,7 +31,9 @@ public function show(Request $request)
     public function verify(Request $request)
     {
         if ($request->route('id') == $request->user()->getKey()) {
-            $request->user()->markEmailAsVerified();
+            if ($request->user()->markEmailAsVerified()) {
+                event(new Verified($request->user()));
+            }
         }
 
         return redirect($this->redirectPath());