要在 Laravel 中創(chuàng)建和注冊(cè)自定義 Guard，1. 創(chuàng)建實(shí)現(xiàn) Guard 接口或繼承 GuardHelpers 的類(lèi)；2. 在服務(wù)提供者中使用 Auth::extend() 注冊(cè)該 Guard；3. 在 auth.php 配置文件中添加新的 Guard 配置項(xiàng)；4. 如需特殊用戶獲取邏輯，還需自定義并注冊(cè) UserProvider。以上步驟完成后，即可通過(guò)指定 Guard 名稱(chēng)調(diào)用自定義認(rèn)證邏輯。

Laravel 提供了非常靈活的機(jī)制來(lái)擴(kuò)展其核心組件，比如自定義 Guard、驅(qū)動(dòng)（Driver）、服務(wù)提供者等。如果你需要實(shí)現(xiàn)特定的認(rèn)證邏輯，比如使用 API Token 或者第三方 OAuth 登錄，擴(kuò)展默認(rèn)的 Guard 是一個(gè)很實(shí)用的做法。

下面我們就來(lái)看看如何在 Laravel 中創(chuàng)建和注冊(cè)一個(gè)自定義 Guard。

創(chuàng)建自定義 Guard 類(lèi)

首先，你需要?jiǎng)?chuàng)建一個(gè)類(lèi)來(lái)實(shí)現(xiàn) Illuminate\Contracts\Auth\Guard 接口，或者更簡(jiǎn)單的方式是繼承 Illuminate\Auth\GuardHelpers 這個(gè)抽象類(lèi)，它已經(jīng)實(shí)現(xiàn)了大部分通用方法。

舉個(gè)例子，我們創(chuàng)建一個(gè)叫 TokenGuard 的類(lèi)：

// app/Services/Auth/TokenGuard.php

namespace App\Services\Auth;

use Illuminate\Auth\GuardHelpers;
use Illuminate\Contracts\Auth\Guard;
use Illuminate\Http\Request;

class TokenGuard implements Guard
{
    use GuardHelpers;

    protected $request;

    public function __construct(Request $request)
    {
        $this->request = $request;
    }

    public function user()
    {
        if ($this->user) {
            return $this->user;
        }

        $token = $this->request->header('Authorization');

        // 假設(shè)你有一個(gè) TokenUserProvider 來(lái)根據(jù) token 獲取用戶
        if ($token && $user = $this->provider->retrieveByToken($token)) {
            $this->user = $user;
        }

        return $this->user;
    }

    public function validate(array $credentials = [])
    {
        // 可選實(shí)現(xiàn)
    }

    public function id()
    {
        return $this->user() ? $this->user()->getAuthIdentifier() : null;
    }
}

這個(gè)類(lèi)主要實(shí)現(xiàn)了兩個(gè)核心方法：user() 和 id()，它們分別用來(lái)獲取當(dāng)前登錄用戶對(duì)象和用戶的唯一標(biāo)識(shí)符。

注冊(cè)自定義 Guard 到 Laravel 容器

接下來(lái)，你需要告訴 Laravel 使用你的 Guard?？梢栽谀硞€(gè)服務(wù)提供者的 boot 方法中使用 Auth::extend() 方法進(jìn)行注冊(cè)。

通常我們會(huì)創(chuàng)建一個(gè)新的服務(wù)提供者，例如 App\Providers\AuthServiceProvider：

php artisan make:provider AuthServiceProvider

然后在 AuthServiceProvider 的 boot 方法中注冊(cè) Guard：

use Illuminate\Support\Facades\Auth;
use Illuminate\Support\ServiceProvider;
use App\Services\Auth\TokenGuard;

class AuthServiceProvider extends ServiceProvider
{
    public function boot()
    {
        Auth::extend('token', function ($app, $name, array $config) {
            return new TokenGuard(
                $app['request']
            );
        });
    }
}

別忘了將這個(gè)服務(wù)提供者添加到 config/app.php 的 providers 數(shù)組中。

配置 auth.php 使用新 Guard

打開(kāi) config/auth.php 文件，在 guards 數(shù)組中添加新的 guard 配置項(xiàng)：

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

    'api' => [
        'driver' => 'token',  // 使用我們剛才注冊(cè)的 guard 名稱(chēng)
        'provider' => 'users',
    ],
],

現(xiàn)在你可以通過(guò) auth('api')->user() 來(lái)調(diào)用你的 TokenGuard 實(shí)現(xiàn)了。

可能需要同時(shí)自定義 UserProvider

如果標(biāo)準(zhǔn)的數(shù)據(jù)庫(kù)用戶提供者不滿足需求，你還可以自定義 UserProvider，讓它實(shí)現(xiàn) Illuminate\Contracts\Auth\UserProvider 接口，并配合你的 Guard 使用。

要注冊(cè)自定義 UserProvider，可以使用 Auth::provider() 方法，例如：

Auth::provider('token', function ($app, array $config) {
    return new TokenUserProvider($app['hash'], $config['model']);
});

這樣就可以在 Guard 中使用 $this->provider->retrieveByToken() 等方法了。

基本上就這些。只要理解了 Guard 的作用和接口要求，擴(kuò)展起來(lái)并不復(fù)雜，但確實(shí)容易忽略某些細(xì)節(jié)，比如構(gòu)造函數(shù)依賴(lài)注入或 provider 的綁定方式。不過(guò)一旦配置完成，就能靈活支持各種認(rèn)證方式了。

以上是如何擴(kuò)展Laravel的核心組件（例如自定義護(hù)罩）。的詳細(xì)內(nèi)容。更多信息請(qǐng)關(guān)注PHP中文網(wǎng)其他相關(guān)文章！