使用 Passport 掌握 Laravel 身份驗證：分步指南

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

---

簡介

為什么使用 Laravel Passport？

Laravel Passport 通過與 Laravel 生態(tài)系統(tǒng)緊密集成來簡化 OAuth2 身份驗證的復(fù)雜性。有了護照，您可以：

• 安全地驗證 API 用戶身份。
• 為移動和網(wǎng)絡(luò)客戶端生成個人訪問令牌。
• 輕松管理令牌過期和撤銷。

---

先決條件

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

1. 對 Laravel 的基本了解。
2. 安裝并配置數(shù)據(jù)庫的 Laravel 項目（建議 v10.x 或更高版本）。
3. 已安裝 PHP 8.0 或更高版本。

如果您尚未設(shè)置項目，請使用以下內(nèi)容創(chuàng)建一個項目：

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

---

第 1 步：安裝 Laravel Passport

安裝包

運行以下命令將 Passport 添加到您的項目中：

composer require laravel/passport

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

發(fā)布 Passport 遷移和配置文件：

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

---

第 2 步：配置 Laravel Passport

安裝加密密鑰和客戶端

運行安裝命令：

php artisan passport:install

這會生成加密密鑰并在您的數(shù)據(jù)庫中創(chuàng)建 OAuth 客戶端。記下輸出，尤其是客戶端 ID 和機密。

可選：創(chuàng)建個人訪問客戶端

要顯式創(chuàng)建個人訪問客戶端，請運行：

php artisan passport:client --personal

---

第 3 步：更新模型

將 HasApiTokens 特征添加到您的用戶模型中：

use Laravel\Passport\HasApiTokens;

class User extends Authenticatable
{
    use HasApiTokens, Notifiable;

    // Other properties...
}

---

第 4 步：更新身份驗證配置

在 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 步：構(gòu)建身份驗證 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']);

創(chuàng)建身份驗證控制器

實施身份驗證方法：

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. 獲取用戶數(shù)據(jù)：使用授權(quán)標頭中的令牌向 /user 發(fā)送 GET 請求。

---

最佳實踐

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

---

結(jié)論

恭喜！您已經(jīng)使用 Laravel Passport 成功實現(xiàn)了 API 身份驗證。此設(shè)置為保護 API 提供了堅實的基礎(chǔ)。探索高級 Passport 功能，例如范圍、令牌撤銷和客戶端憑據(jù)，以進一步增強應(yīng)用程序的安全性。

---

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