Laravel核心程式碼學習–使用者認證系統的實現細節

kevinyan發表於2019-03-01

使用者認證系統的實現細節

上一節我們介紹了Laravel Auth系統的基礎知識,說了他的核心元件都有哪些構成,這一節我們會專注Laravel Auth系統的實現細節,主要關注Auth也就是AuthManager是如何裝載認證用的看守器(Guard)和使用者提供器(UserProvider)以及預設的使用者註冊和登入的實現細節,通過梳理這些實現細節我們也就能知道應該如何定製Auth認證來滿足我們自己專案中使用者認證的需求的。

通過AuthManager裝載看守器和使用者提供器

AuthManager裝載看守器和使用者提供器用到的方法比較多,用文字描述不太清楚,我們通過註解這個過程中用到的方法來看具體的實現細節。

namespace IlluminateAuth;
class AuthManager implements FactoryContract
{
    /**
     * 嘗試從$guards屬性中獲取指定的Guard
     *
     * @param  string  $name
     * @return IlluminateContractsAuthGuard|IlluminateContractsAuthStatefulGuard
     */
    public function guard($name = null)
    {
        $name = $name ?: $this->getDefaultDriver();

        return isset($this->guards[$name])
                    ? $this->guards[$name]
                    : $this->guards[$name] = $this->resolve($name);
    }
    
    /**
     * 解析出給定name的Guard
     *
     * @param  string  $name
     * @return IlluminateContractsAuthGuard|IlluminateContractsAuthStatefulGuard
     *
     * @throws InvalidArgumentException
     */
    protected function resolve($name)
    {
        //獲取Guard的配置
        //$config = [`driver` => `session`, `provider` => `users`]
        $config = $this->getConfig($name);

        if (is_null($config)) {
            throw new InvalidArgumentException("Auth guard [{$name}] is not defined.");
        }
	   //如果通過extend方法為guard定義了驅動器,這裡去呼叫自定義的Guard驅動器
        if (isset($this->customCreators[$config[`driver`]])) {
            return $this->callCustomCreator($name, $config);
        }
        //Laravel auth預設的配置這裡是執行createSessionDriver
        $driverMethod = `create`.ucfirst($config[`driver`]).`Driver`;

        if (method_exists($this, $driverMethod)) {
            return $this->{$driverMethod}($name, $config);
        }

        throw new InvalidArgumentException("Auth guard driver [{$name}] is not defined.");
    }
    
    /**
     * 從config/auth.php中獲取給定名稱的Guard的配置
     *
     * @param  string  $name
     * @return array
     */
    `guards` => [
        `web` => [
            `driver` => `session`,
            `provider` => `users`,
        ],

        `api` => [
            `driver` => `token`,
            `provider` => `users`,
        ],
    ],
    protected function getConfig($name)
    {
        //`guards` => [
        //    `web` => [
        //        `driver` => `session`,
        //        `provider` => `users`,
        //    ],

        //    `api` => [
        //        `driver` => `token`,
        //        `provider` => `users`,
        //    ],
        //],
        // 根據Laravel預設的auth配置, 這個方法會獲取key "web"對應的陣列
        return $this->app[`config`]["auth.guards.{$name}"];
    }
    
    /**
     * 呼叫自定義的Guard驅動器
     *
     * @param  string  $name
     * @param  array  $config
     * @return mixed
     */
    protected function callCustomCreator($name, array $config)
    {
        return $this->customCreators[$config[`driver`]]($this->app, $name, $config);
    }
    
    /**
     * 註冊一個自定義的閉包Guard 驅動器 到customCreators屬性中
     *
     * @param  string  $driver
     * @param  Closure  $callback
     * @return $this
     */
    public function extend($driver, Closure $callback)
    {
        $this->customCreators[$driver] = $callback;

        return $this;
    }
    
    /**
     * 註冊一個自定義的使用者提供器建立器到 customProviderCreators屬性中
     *
     * @param  string  $name
     * @param  Closure  $callback
     * @return $this
     */
    public function provider($name, Closure $callback)
    {
        $this->customProviderCreators[$name] = $callback;

        return $this;
    }
    
    /**
     * 建立基於session的認證看守器 SessionGuard
     *
     * @param  string  $name
     * @param  array  $config
     * @return IlluminateAuthSessionGuard
     */
    public function createSessionDriver($name, $config)
    {
    	//$config[`provider`] == `users`
        $provider = $this->createUserProvider($config[`provider`] ?? null);

        $guard = new SessionGuard($name, $provider, $this->app[`session.store`]);

        if (method_exists($guard, `setCookieJar`)) {
            $guard->setCookieJar($this->app[`cookie`]);
        }

        if (method_exists($guard, `setDispatcher`)) {
            $guard->setDispatcher($this->app[`events`]);
        }

        if (method_exists($guard, `setRequest`)) {
            $guard->setRequest($this->app->refresh(`request`, $guard, `setRequest`));
        }

        return $guard;
    }
    
    //建立Guard驅動依賴的使用者提供器物件
    public function createUserProvider($provider = null)
    {
        if (is_null($config = $this->getProviderConfiguration($provider))) {
            return;
        }
        //如果通過Auth::provider方法註冊了自定義的使用者提供器creator閉包則去呼叫閉包獲取使用者提供器物件
        if (isset($this->customProviderCreators[$driver = ($config[`driver`] ?? null)])) {
            return call_user_func(
                $this->customProviderCreators[$driver], $this->app, $config
            );
        }

        switch ($driver) {
            case `database`:
                return $this->createDatabaseProvider($config);
            case `eloquent`:
                //通過預設的auth配置這裡會返回EloquentUserProvider物件,它實現了IlluminateContractsAuth 介面
                return $this->createEloquentProvider($config);
            default:
                throw new InvalidArgumentException(
                    "Authentication user provider [{$driver}] is not defined."
                );
        }
    }
    
    /**
     * 會通過__call去動態地呼叫AuthManager代理的Guard的使用者認證相關方法
     * 根據預設配置,這裡__call會去呼叫SessionGuard裡的方法
     * @param  string  $method
     * @param  array  $parameters
     * @return mixed
     */
    public function __call($method, $parameters)
    {
        return $this->guard()->{$method}(...$parameters);
    }
}


複製程式碼

註冊使用者

Laravel Auth系統中預設的註冊路由如下:

$this->post(`register`, `AuthRegisterController@register`);
複製程式碼

所以使用者註冊的邏輯是由RegisterController的register方法來完成的

class RegisterController extends Controller
{
    //方法定義在IlluminateFoundationAuthRegisterUsers中
    public function register(Request $request)
    {
        $this->validator($request->all())->validate();

        event(new Registered($user = $this->create($request->all())));

        $this->guard()->login($user);

        return $this->registered($request, $user)
        
     }
     
    protected function validator(array $data)
    {
        return Validator::make($data, [
            `name` => `required|string|max:255`,
            `email` => `required|string|email|max:255|unique:users`,
            `password` => `required|string|min:6|confirmed`,
        ]);
    }
    
    protected function create(array $data)
    {
        return User::create([
            `name` => $data[`name`],
            `email` => $data[`email`],
            `password` => bcrypt($data[`password`]),
        ]);
    }
         
}
複製程式碼

register的流程很簡單,就是驗證使用者輸入的資料沒問題後將這些資料寫入資料庫生成使用者,其中密碼加密採用的是bcrypt演算法,如果你需要改成常用的salt加密碼明文做雜湊的密碼加密方法可以在create方法中對這部分邏輯進行更改,註冊完使用者後會呼叫SessionGuard的login方法把使用者資料裝載到應用中,注意這個login方法沒有登入認證,只是把認證後的使用者裝載到應用中這樣在應用裡任何地方我們都能夠通過Auth::user()來獲取使用者資料啦。

使用者登入認證

Laravel Auth系統的登入路由如下

$this->post(`login`, `AuthLoginController@login`);
複製程式碼

我們看一下LoginController裡的登入邏輯

class LoginController extends Controller
{
    /**
     * 處理登入請求
     */
    public function login(Request $request)
    {
        //驗證登入欄位
        $this->validateLogin($request);
        //防止惡意的多次登入嘗試
        if ($this->hasTooManyLoginAttempts($request)) {
            $this->fireLockoutEvent($request);

            return $this->sendLockoutResponse($request);
        }
        //進行登入認證
        if ($this->attemptLogin($request)) {
            return $this->sendLoginResponse($request);
        }

        $this->incrementLoginAttempts($request);

        return $this->sendFailedLoginResponse($request);
    }
    
    //嘗試進行登入認證
    protected function attemptLogin(Request $request)
    {
        return $this->guard()->attempt(
            $this->credentials($request), $request->filled(`remember`)
        );
    }
    
    //獲取登入用的欄位值
    protected function credentials(Request $request)
    {
        return $request->only($this->username(), `password`);
    }
}
複製程式碼

可以看到,登入認證的邏輯是通過SessionGuardattempt方法來實現的,其實就是Auth::attempt(), 下面我們來看看attempt方法裡的邏輯:

class SessionGuard implements StatefulGuard, SupportsBasicAuth
{
    public function attempt(array $credentials = [], $remember = false)
    {
        $this->fireAttemptEvent($credentials, $remember);

        $this->lastAttempted = $user = $this->provider->retrieveByCredentials($credentials);
	   //如果登入認證通過,通過login方法將使用者物件裝載到應用裡去
        if ($this->hasValidCredentials($user, $credentials)) {
            $this->login($user, $remember);

            return true;
        }
        //登入失敗的話,可以觸發事件通知使用者有可疑的登入嘗試(需要自己定義listener來實現)
        $this->fireFailedEvent($user, $credentials);

        return false;
    }
    
    protected function hasValidCredentials($user, $credentials)
    {
        return ! is_null($user) && $this->provider->validateCredentials($user, $credentials);
    }
}
複製程式碼

SessionGuardattempt方法首先通過使用者提供器的retriveBycredentials方法通過使用者名稱從使用者表中查詢出使用者資料,認證使用者資訊是通過使用者提供器的validateCredentials來實現的,所有使用者提供器的實現類都會實現UserProvider契約(interface)中定義的方法,通過上面的分析我們知道預設的使用者提供器是EloquentUserProvider

class EloquentUserProvider implements UserProvider
{
    從資料庫中取出使用者例項
    public function retrieveByCredentials(array $credentials)
    {
        if (empty($credentials) ||
           (count($credentials) === 1 &&
            array_key_exists(`password`, $credentials))) {
            return;
        }

        $query = $this->createModel()->newQuery();

        foreach ($credentials as $key => $value) {
            if (! Str::contains($key, `password`)) {
                $query->where($key, $value);
            }
        }

        return $query->first();
    }
    
    //通過給定使用者認證資料來驗證使用者
    public function validateCredentials(UserContract $user, array $credentials)
    {
        $plain = $credentials[`password`];

        return $this->hasher->check($plain, $user->getAuthPassword());
    }
}

class BcryptHasher implements HasherContract
{
    //通過bcrypt演算法計算給定value的雜湊值
    public function make($value, array $options = [])
    {
        $hash = password_hash($value, PASSWORD_BCRYPT, [
            `cost` => $this->cost($options),
        ]);

        if ($hash === false) {
            throw new RuntimeException(`Bcrypt hashing not supported.`);
        }

        return $hash;
    }
    
    //驗證雜湊值是否給定明文值通過bcrypt演算法計算得到的
    public function check($value, $hashedValue, array $options = [])
    {
        if (strlen($hashedValue) === 0) {
            return false;
        }

        return password_verify($value, $hashedValue);
    }
}
複製程式碼

使用者密碼的驗證是通過EloquentUserProvider依賴的hasher雜湊器來完成的,Laravel認證系統預設採用bcrypt演算法來加密使用者提供的明文密碼然後儲存到使用者表裡的,驗證時haser雜湊器的check方法會通過PHP內建方法password_verify來驗證明文密碼是否是儲存的密文密碼的原值。

使用者認證系統的主要細節梳理完後我們就知道如何定義我們自己的看守器(Guard)或使用者提供器(UserProvider)了,首先他們必須實現各自遵守的契約裡的方法才能夠無縫接入到Laravel的Auth系統中,然後還需要將自己定義的Guard或Provider通過Auth::extendAuth::provider方法註冊返回Guard或者Provider例項的閉包到Laravel中去,Guard和UserProvider的自定義不是必須成套的,我們可以單獨自定義Guard仍使用預設的EloquentUserProvider,或者讓預設的SessionGuard使用自定義的UserProvider。

下一節我會給出一個我們以前專案開發中用到的一個案例來更好地講解應該如何對Laravel Auth系統進行擴充套件。

本文已經收錄在系列文章Laravel原始碼學習裡,歡迎訪問閱讀。

相關文章