使用 Passport 掌握 Laravel 驗(yàn)證：逐步指南

身份驗(yàn)證是現(xiàn)代 Web 應(yīng)用程式的基石。在 Laravel 中，Passport 提供了完整的 OAuth2 伺服器實(shí)現(xiàn)，可以無縫地實(shí)現(xiàn) API 驗(yàn)證。本指南將引導(dǎo)您完成設(shè)定 Laravel Passport 的整個(gè)流程，從安裝到保護(hù)和測(cè)試 API。

---

簡(jiǎn)介

為什麼要使用 Laravel Passport？

Laravel Passport 透過與 Laravel 生態(tài)系統(tǒng)緊密整合來簡(jiǎn)化 OAuth2 身分驗(yàn)證的複雜性。有了護(hù)照，您可以：

• 安全地驗(yàn)證 API 使用者身分。
• 為行動(dòng)和網(wǎng)路用戶端產(chǎn)生個(gè)人存取權(quán)杖。
• 輕鬆管理令牌過期和撤銷。

---

先決條件

開始之前，請(qǐng)確保您擁有：

1. 對(duì) Laravel 的基本了解。
2. 安裝並設(shè)定資料庫的 Laravel 專案（建議 v10.x 或更高版本）。
3. 已安裝 PHP 8.0 或更高版本。

如果您尚未設(shè)定項(xiàng)目，請(qǐng)使用以下內(nèi)容建立項(xiàng)目：

composer create-project --prefer-dist laravel/laravel passport-auth
cd passport-auth

---

第 1 步：安裝 Laravel Passport

安裝包

執(zhí)行以下命令將 Passport 新增至您的專案：

composer require laravel/passport

發(fā)布和遷移護(hù)照文件

發(fā)布 Passport 遷移和設(shè)定檔：

php artisan vendor:publish --tag=passport-migrations
php artisan migrate

---

第 2 步：配置 Laravel Passport

安裝加密金鑰和用戶端

執(zhí)行安裝指令：

php artisan passport:install

這會(huì)產(chǎn)生加密金鑰並在您的資料庫中建立 OAuth 用戶端。記下輸出，尤其是客戶端 ID 和機(jī)密。

可選：建立個(gè)人存取用戶端

要明確建立個(gè)人存取用戶端，請(qǐng)執(zhí)行：

php artisan passport:client --personal

---

第 3 步：更新模型

將 HasApiTokens 特徵加入您的使用者模型：

use Laravel\Passport\HasApiTokens;

class User extends Authenticatable
{
    use HasApiTokens, Notifiable;

    // Other properties...
}

---

第 4 步：更新驗(yàn)證設(shè)定

在 config/auth.php 中將 Passport 配置為 API Guard 的驅(qū)動(dòng)程式：

'guards' => [
    'api' => [
        'driver' => 'passport',
        'provider' => 'users',
    ],
],

---

第5步：註冊(cè)護(hù)照路線

在AppProvidersAppServiceProvider中，載入Passport的路由：

use Laravel\Passport\Passport;

public function boot(): void
{
    Passport::routes();
    Passport::tokensExpireIn(now()->addDays(15));
    Passport::refreshTokensExpireIn(now()->addDays(30));
    Passport::personalAccessTokensExpireIn(now()->addMonths(6));
}

---

第 6 步：建立驗(yàn)證 API 端點(diǎn)

新增路線

在routes/api.php中定義API路由：

use App\Http\Controllers\AuthController;

Route::post('/register', [AuthController::class, 'register']);
Route::post('/login', [AuthController::class, 'login']);
Route::middleware('auth:api')->get('/user', [AuthController::class, 'user']);

建立身份驗(yàn)證控制器

實(shí)作驗(yàn)證方法：

composer create-project --prefer-dist laravel/laravel passport-auth
cd passport-auth

---

第 7 步：設(shè)定加密金鑰的權(quán)限

確保安全存取護(hù)照金鑰：

composer require laravel/passport

驗(yàn)證權(quán)限：

php artisan vendor:publish --tag=passport-migrations
php artisan migrate

預(yù)期輸出：

php artisan passport:install

---

第 8 步：測(cè)試 API

使用 Postman 或任何 API 用戶端來測(cè)試端點(diǎn)：

1. 註冊(cè)： 使用姓名、電子郵件和密碼向 /register 發(fā)送 POST 請(qǐng)求。
2. 登入：使用電子郵件和密碼向 /login 發(fā)送 POST 請(qǐng)求。
3. 取得使用者資料：使用授權(quán)標(biāo)頭中的令牌向 /user 發(fā)送 GET 請(qǐng)求。

---

最佳實(shí)踐

• 在生產(chǎn)中使用 HTTPS。
• 定期輪換加密金鑰。
• 徹底驗(yàn)證輸入。
• 限制令牌範(fàn)圍以提高安全性。

---

結(jié)論

恭喜！您已經(jīng)使用 Laravel Passport 成功實(shí)作了 API 驗(yàn)證。此設(shè)定為保護(hù) API 提供了堅(jiān)實(shí)的基礎(chǔ)。探索進(jìn)階 Passport 功能，例如範(fàn)圍、令牌撤銷和用戶端憑證，以進(jìn)一步增強(qiáng)應(yīng)用程式的安全性。

---

以上是使用 Passport 進(jìn)行 Laravel 身份驗(yàn)證的詳細(xì)內(nèi)容。更多資訊請(qǐng)關(guān)注PHP中文網(wǎng)其他相關(guān)文章！