使用 Passport 掌握 Laravel 驗證：逐步指南

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

---

簡介

為什麼要使用 Laravel Passport？

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

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

---

先決條件

開始之前，請確保您擁有：

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

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

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

---

第 1 步：安裝 Laravel Passport

安裝包

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

composer require laravel/passport

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

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

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

---

第 2 步：配置 Laravel Passport

安裝加密金鑰和用戶端

執(zhí)行安裝指令：

php artisan passport:install

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

可選：建立個人存取用戶端

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

php artisan passport:client --personal

---

第 3 步：更新模型

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

use Laravel\Passport\HasApiTokens;

class User extends Authenticatable
{
    use HasApiTokens, Notifiable;

    // Other properties...
}

---

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

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

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

---

第5步：註冊護照路線

在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 步：建立驗證 API 端點

新增路線

在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']);

建立身份驗證控制器

實作驗證方法：

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

---

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

確保安全存取護照金鑰：

composer require laravel/passport

驗證權(quán)限：

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

預(yù)期輸出：

php artisan passport:install

---

第 8 步：測試 API

使用 Postman 或任何 API 用戶端來測試端點：

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

---

最佳實踐

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

---

結(jié)論

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

---

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