Merge branch 'rtconner/9.x' into 9.x

Author: taylorotwell

src/Illuminate/Auth/GuardHelpers.php

@@ -95,6 +95,18 @@ public function setUser(AuthenticatableContract $user)
         return $this;
     }
 
+    /**
+     * Forget the current user.
+     *
+     * @return $this
+     */
+    public function forgetUser()
+    {
+        $this->user = null;
+
+        return $this;
+    }
+
     /**
      * Get the user provider used by the guard.
      *

tests/Auth/AuthGuardTest.php

@@ -588,6 +588,14 @@ public function testLoginOnceFailure()
         $this->assertFalse($guard->once(['foo']));
     }
 
+    public function testForgetUserSetsUserToNull()
+    {
+        $user = m::mock(Authenticatable::class);
+        $guard = $this->getGuard()->setUser($user);
+        $guard->forgetUser();
+        $this->assertNull($guard->getUser());
+    }
+
     protected function getGuard()
     {
         [$session, $provider, $request, $cookie, $timebox] = $this->getMocks();