前言

Laravel 默認的 auth 功能已經是很全面了，但是我們也經常會碰到一些需要自定義的一些情況，比如驗證的字段和默認的不匹配，比如需要能夠同時滿足 user name 和 email 認證等等。如何創建一個完全自定義的認證呢？相比一個教程，我更傾向于介紹一下工作原理，這樣在自己修改或自定義的過程中更得心應手。

Authenticatable 接口

Illuminate/Contracts/Auth/Authenticatable

Authenticatable 定義了一個可以被用來認證的模型或類需要實現的接口，也就是說，如果需要用一個自定義的類來做認證，需要實現這個接口定義的方法。

// 獲取唯一標識的，可以用來認證的字段名，比如 id，uuidpublic function getAuthIdentifierName();// 獲取該標示符對應的值public function getAuthIdentifier();// 獲取認證的密碼public function getAuthPassword();// 獲取remember tokenpublic function getRememberToken();// 設置 remember tokenpublic function setRememberToken($value);// 獲取 remember token 對應的字段名，比如默認的 'remember_token'public function getRememberTokenName();

比如你的認證模型需要用 'token' 而不是 'password' 來作為密碼驗證，這個時候就可以修改 getAuthPassword() 方法的返回值為 'token';

Authenticatable trait

Illuminate/Auth/Authenticatable

Laravel 中定義的 Authenticatable trait，也是 Laravel auth 默認的 User 模型使用的 trait，這個 trait 定義了 User 模型默認認證標示符為 'id'，密碼字段為 'password'，remember token 對應的字段為 remember_token 等等。

通過重寫 User 模型的這些方法可以修改一些設置。

Guard 接口

Illuminate/Contracts/Auth/Guard

Guard 接口定義了某個實現了 Authenticatable (可認證的) 模型或類的認證方法以及一些常用的接口。

// 判斷當前用戶是否登錄public function check();// 判斷當前用戶是否是游客（未登錄）public function guest();// 獲取當前認證的用戶public function user();// 獲取當前認證用戶的 id，嚴格來說不一定是 id，應該是上個模型中定義的唯一的字段名public function id();// 根據提供的消息認證用戶public function validate(array $credentials = []);// 設置當前用戶public function setUser(Authenticatable $user);

StatefulGuard 接口

Illuminate/Contracts/Auth/StatefulGuard

StatefulGuard 接口繼承自 Guard 接口，除了 Guard 里面定義的一些基本接口外，還增加了更進一步、有狀態的 Guard.

新添加的接口有這些：

// 嘗試根據提供的憑證驗證用戶是否合法public function attempt(array $credentials = [], $remember = false);// 一次性登錄，不記錄session or cookiepublic function once(array $credentials = []);// 登錄用戶，通常在驗證成功后記錄 session 和 cookie public function login(Authenticatable $user, $remember = false);// 使用用戶 id 登錄public function loginUsingId($id, $remember = false);// 使用用戶 ID 登錄，但是不記錄 session 和 cookiepublic function onceUsingId($id);// 通過 cookie 中的 remember token 自動登錄public function viaRemember();// 登出public function logout();

Laravel 中默認提供了 3 中 guard：RequestGuard，TokenGuard，SessionGuard.

RequestGuard

Illuminate/Auth/RequestGuard

RequestGuard 是一個非常簡單的 guard. RequestGuard 是通過傳入一個閉包來認證的。可以通過調用 Auth::viaRequest 添加一個自定義的 RequestGuard.

SessionGuard

Illuminate/Auth/SessionGuard

SessionGuard 是 Laravel web 認證默認的 guard.

TokenGuard

Illuminate/Auth/TokenGuard

TokenGuard 適用于無狀態 api 認證，通過 token 認證.

UserProvider 接口

Illuminate/Contracts/Auth/UserProvider

UserProvider 接口定義了獲取認證模型的方法，比如根據 id 獲取模型，根據 email 獲取模型等等.

// 通過唯一標示符獲取認證模型public function retrieveById($identifier);// 通過唯一標示符和 remember token 獲取模型public function retrieveByToken($identifier, $token);// 通過給定的認證模型更新 remember tokenpublic function updateRememberToken(Authenticatable $user, $token);// 通過給定的憑證獲取用戶，比如 email 或用戶名等等public function retrieveByCredentials(array $credentials);// 認證給定的用戶和給定的憑證是否符合public function validateCredentials(Authenticatable $user, array $credentials);

Laravel 中默認有兩個 user provider: DatabaseUserProvider & EloquentUserProvider.

DatabaseUserProvider

Illuminate/Auth/DatabaseUserProvider

直接通過數據庫表來獲取認證模型.

EloquentUserProvider

Illuminate/Auth/EloquentUserProvider

通過 eloquent 模型來獲取認證模型

AuthManager

Illuminate/Auth/AuthManager

Guard 用來認證一個用戶是否認證成功， UserProvider 用來提供認證模型的來源，而根據項目的 config 管理 guard 以及自定義 guard 等等功能，則是通過 AuthManager 來實現。

AuthManager 應該是有點像策略模式里面的 Context 類以及工廠方法里面的工廠，一方面管理 Guard，另外一方面通過 __call 魔術方法調用具體的策略(Guard)方法。

Auth facade 對應的實現類就是 AuthManager，AuthManager 在容器中注冊為單例，用來管理所有的 guard、user provider 以及 guard 的代理工作。

自定義認證

根據上面的知識，可以知道要自定義一個認證很簡單。

• 創建認證模型

創建一個自定義的認證模型，實現 Authenticatable 接口；

• 創建自定義的 UserProvider

創建一個自定義的 UserProvider，實現 UserProvider 接口，可以返回上面自定義的認證模型；

• 創建自定義的 Guard

創建一個自定義的 Guard，實現 Guard或StatefulGuard 接口

• 添加 guard creator 和 user provider creator 到 AuthManager 中

在 AppServiceProvider 的 boot 方法添加如下代碼：

Auth::extend('myguard', function(){ ... return new MyGuard(); //返回自定義 guard 實例 ...});Auth::provider('myuserprovider', function(){ return new MyUserProvider(); // 返回自定義的 user provider});

在 config/auth.php的 guards 數組中添加自定義 guard，一個自定義 guard 包括兩部分： driver 和 provider.

'oustn' => [ 'driver' => 'myguard', 'provider' => 'myusers',],

在 config/auth.php的 providers 數組中添加自定義 user provider.

'myusers' => [ 'driver' => 'myuserprovider' // 里面具體的字段可以根據你創建 user provider 需要的信息自由添加，可以通過 Auth::createUserProvider('myuserprovider') 創建],

設置 config/auth.php 的 defaults.guard 為 oustn.

總結

以上就是這篇文章的全部內容了，希望本文的內容對大家的學習或者工作具有一定的參考學習價值，如果有疑問大家可以留言交流，謝謝大家對VeVb武林網的支持。