摘要：系統(tǒng)的核心是由的認證組件的看守器和提供器組成。使用的認證系統(tǒng)，幾乎所有東西都已經(jīng)為你配置好了。其配置文件位于，其中包含了用于調(diào)整認證服務(wù)行為的注釋清晰的選項配置。

使用過Laravel的開發(fā)者都知道，Laravel自帶了一個認證系統(tǒng)來提供基本的用戶注冊、登錄、認證、找回密碼，如果Auth系統(tǒng)里提供的基礎(chǔ)功能不滿足需求還可以很方便的在這些基礎(chǔ)功能上進行擴展。這篇文章我們先來了解一下Laravel Auth系統(tǒng)的核心組件。

Auth系統(tǒng)的核心是由 Laravel 的認證組件的「看守器」和「提供器」組成?？词仄鞫x了該如何認證每個請求中用戶。例如，Laravel 自帶的 session 看守器會使用 session 存儲和 cookies 來維護狀態(tài)。

下表列出了Laravel Auth系統(tǒng)的核心部件

在本文中我們會詳細介紹這些核心部件，然后在文章的最后更新每個部件的作用細節(jié)到上面給出的這個表中。

只需在新的 Laravel 應(yīng)用上運行?php artisan make:auth?和?php artisan migrate?命令就能夠在項目里生成Auth系統(tǒng)需要的路由和視圖以及數(shù)據(jù)表。

php artisan make:auth執(zhí)行后會生成Auth認證系統(tǒng)需要的視圖文件，此外還會在路由文件web.php中增加響應(yīng)的路由:

Auth::routes();

Auth Facade文件中多帶帶定義了routes這個靜態(tài)方法

public static function routes()
{
    static::$app->make("router")->auth();
}

所以Auth具體的路由方法都定義在IlluminateRoutingRouter的auth方法中，關(guān)于如何找到Facade類代理的實際類可以翻看之前Facade源碼分析的章節(jié)。

namespace IlluminateRouting;
class Router implements RegistrarContract, BindingRegistrar
{
    /**
     * Register the typical authentication routes for an application.
     *
     * @return void
     */
    public function auth()
    {
        // Authentication Routes...
        $this->get("login", "AuthLoginController@showLoginForm")->name("login");
        $this->post("login", "AuthLoginController@login");
        $this->post("logout", "AuthLoginController@logout")->name("logout");

        // Registration Routes...
        $this->get("register", "AuthRegisterController@showRegistrationForm")->name("register");
        $this->post("register", "AuthRegisterController@register");

        // Password Reset Routes...
        $this->get("password/reset", "AuthForgotPasswordController@showLinkRequestForm")->name("password.request");
        $this->post("password/email", "AuthForgotPasswordController@sendResetLinkEmail")->name("password.email");
        $this->get("password/reset/{token}", "AuthResetPasswordController@showResetForm")->name("password.reset");
        $this->post("password/reset", "AuthResetPasswordController@reset");
    }
}

在auth方法里可以清晰的看到認證系統(tǒng)里提供的所有功能的路由URI以及對應(yīng)的控制器和方法。

使用Laravel的認證系統(tǒng)，幾乎所有東西都已經(jīng)為你配置好了。其配置文件位于 config/auth.php，其中包含了用于調(diào)整認證服務(wù)行為的注釋清晰的選項配置。

 [
        "guard" => "web",
        "passwords" => "users",
    ],

    /*
    |--------------------------------------------------------------------------
    | Authentication Guards
    |--------------------------------------------------------------------------
    |
    | 定義項目使用的認證看守器，默認的看守器使用session驅(qū)動和Eloquent User 用戶數(shù)據(jù)提供者
    |
    | 所有的驅(qū)動都有一個用戶提供者，它定義了如何從數(shù)據(jù)庫或者應(yīng)用使用的持久化用戶數(shù)據(jù)的存儲中取出用戶信息
    |
    | Supported: "session", "token"
    |
    */

    "guards" => [
        "web" => [
            "driver" => "session",
            "provider" => "users",
        ],

        "api" => [
            "driver" => "token",
            "provider" => "users",
        ],
    ],

    /*
    |--------------------------------------------------------------------------
    | User Providers
    |--------------------------------------------------------------------------
    |
    | 所有的驅(qū)動都有一個用戶提供者，它定義了如何從數(shù)據(jù)庫或者應(yīng)用使用的持久化用戶數(shù)據(jù)的存儲中取出用戶信息
    |
    | Laravel支持通過不同的Guard來認證用戶，這里可以定義Guard的用戶數(shù)據(jù)提供者的細節(jié):
    |        使用什么driver以及對應(yīng)的Model或者table是什么
    |
    | Supported: "database", "eloquent"
    |
    */

    "providers" => [
        "users" => [
            "driver" => "eloquent",
            "model" => AppModelsUser::class,
        ],

        // "users" => [
        //     "driver" => "database",
        //     "table" => "users",
        // ],
    ],

    /*
    |--------------------------------------------------------------------------
    | 重置密碼相關(guān)的配置
    |--------------------------------------------------------------------------
    |
    */

    "passwords" => [
        "users" => [
            "provider" => "users",
            "table" => "password_resets",
            "expire" => 60,
        ],
    ],

];

Auth系統(tǒng)的核心是由 Laravel 的認證組件的「看守器」和「提供器」組成?？词仄鞫x了該如何認證每個請求中用戶。例如，Laravel 自帶的 session 看守器會使用 session 存儲和 cookies 來維護狀態(tài)。

提供器中定義了該如何從持久化的存儲數(shù)據(jù)中檢索用戶。Laravel 自帶支持使用 Eloquent 和數(shù)據(jù)庫查詢構(gòu)造器來檢索用戶。當(dāng)然，你可以根據(jù)需要自定義其他提供器。

所以上面的配置文件的意思是Laravel認證系統(tǒng)默認使用了web guard配置項， 配置項里使用的是看守器是SessionGuard，使用的用戶提供器是EloquentProvider 提供器使用的model是AppUser。

看守器定義了該如何認證每個請求中用戶。Laravel自帶的認證系統(tǒng)默認使用自帶的 SessionGuard ，SessionGuard除了實現(xiàn)IlluminateContractsAuth契約里的方法還實現(xiàn)IlluminateContractsAuthStatefulGuard 和IlluminateContractsAuthSupportsBasicAuth契約里的方法，這些Guard Contracts里定義的方法都是Laravel Auth系統(tǒng)默認認證方式依賴的基礎(chǔ)方法。

我們先來看一下這一些基礎(chǔ)方法都意欲完成什么操作，等到分析Laravel是如何通過SessionGuard認證用戶時在去關(guān)系這些方法的具體實現(xiàn)。

這個文件定義了基礎(chǔ)的認證方法

namespace IlluminateContractsAuth;

interface Guard
{
    /**
     * 返回當(dāng)前用戶是否時已通過認證，是返回true，否者返回false
     *
     * @return bool
     */
    public function check();

    /**
     * 驗證是否時訪客用戶(非登錄認證通過的用戶)
     *
     * @return bool
     */
    public function guest();

    /**
     * 獲取當(dāng)前用戶的用戶信息數(shù)據(jù)，獲取成功返回用戶User模型實例(AppUser實現(xiàn)了Authenticatable接口)
     * 失敗返回null
     * @return IlluminateContractsAuthAuthenticatable|null
     */
    public function user();

    /**
     * 獲取當(dāng)前認證用戶的用戶ID，成功返回ID值，失敗返回null
     *
     * @return int|null
     */
    public function id();

    /**
     * 通過credentials(一般是郵箱和密碼)驗證用戶
     *
     * @param  array  $credentials
     * @return bool
     */
    public function validate(array $credentials = []);

    /**
     * 將一個AppUser實例設(shè)置成當(dāng)前的認證用戶
     *
     * @param  IlluminateContractsAuthAuthenticatable  $user
     * @return void
     */
    public function setUser(Authenticatable $user);
}

這個Contracts定義了Laravel auth系統(tǒng)里認證用戶時使用的方法，除了認證用戶外還會涉及用戶認證成功后如何持久化用戶的認證狀態(tài)。

IlluminateContractsAuthSupportsBasicAuth
定義了通過Http Basic Auth 認證用戶的方法
namespace IlluminateContractsAuth;

interface SupportsBasicAuth
{
    /**
     * 嘗試通過HTTP Basic Auth來認證用戶
     *
     * @param  string  $field
     * @param  array  $extraConditions
     * @return SymfonyComponentHttpFoundationResponse|null
     */
    public function basic($field = "email", $extraConditions = []);

    /**
     * 進行無狀態(tài)的Http Basic Auth認證 (認證后不會設(shè)置session和cookies)
     *
     * @param  string  $field
     * @param  array  $extraConditions
     * @return SymfonyComponentHttpFoundationResponse|null
     */
    public function onceBasic($field = "email", $extraConditions = []);
}
User Provider
用戶提供器中定義了該如何從持久化的存儲數(shù)據(jù)中檢索用戶，Laravel定義了用戶提供器契約(interface)，所有用戶提供器都要實現(xiàn)這個接口里定義的抽象方法，因為實現(xiàn)了統(tǒng)一的接口所以使得無論是Laravel 自帶的還是自定義的用戶提供器都能夠被Guard使用。
用戶提供器契約
如下是契約中定義的必需被用戶提供器實現(xiàn)的抽象方法:

通過配置文件config/auth.php可以看到Laravel默認使用的用戶提供器是IlluminateAuthEloquentUserProvider , 下一章節(jié)我們分析Laravel Auth系統(tǒng)實現(xiàn)細節(jié)的時候我們再來看看EloquentUserProvider是怎么實現(xiàn)用戶提供器契約中的抽象方法的。
總結(jié)
本節(jié)我們主要介紹Laravel Auth系統(tǒng)的基礎(chǔ)，包括Auth系統(tǒng)的核心組件看守器和提供器，AuthManager通過調(diào)用配置文件里指定的看守器來完成用戶認證，在認證過程需要的用戶數(shù)據(jù)是看守器通過用戶提供器獲取到的，下面的表格里總結(jié)了Auth系統(tǒng)的核心部件以及每個部件的作用。


名稱
作用



Auth
AuthManager的Facade


AuthManager
Auth認證系統(tǒng)面向外部的接口，認證系統(tǒng)通過它向應(yīng)用提供所有Auth用戶認證相關(guān)的方法，而認證方法的具體實現(xiàn)細節(jié)由它代理的具體看守器（Guard）來完成。


Guard
看守器，定義了該如何認證每個請求中用戶，認證時需要的用戶數(shù)據(jù)會通過用戶數(shù)據(jù)提供器來獲取。


User Provider
用戶提供器，定義了如何從持久化的存儲數(shù)據(jù)中檢索用戶，Guard認證用戶時會通過提供器取用戶的數(shù)據(jù)，所有的提供器都是IlluminateContractsAuthUserProvider接口的實現(xiàn)，提供了從持久化存儲中取用戶數(shù)據(jù)的具體實現(xiàn)細節(jié)。



下一章節(jié)我們會看看Laravel自帶的用戶認證功能的實現(xiàn)細節(jié)。
本文已經(jīng)收錄在系列文章Laravel源碼學(xué)習(xí)里，歡迎訪問閱讀。