Laravel Sanctum 是一個(gè)輕量級(jí)API 認(rèn)證系統(tǒng)，適合前後端分離項(xiàng)目。 1. 安裝需Laravel 7.x 以上版本，通過Composer 安裝並發(fā)布配置文件與遷移文件，運(yùn)行遷移並根據(jù)需要配置域名和stateful 設(shè)置。 2. 用戶登錄可生成簡(jiǎn)單token 或帶權(quán)限的個(gè)性化token，使用createToken 方法獲取plainTextToken 返回給前端。 3. 保護(hù)API 路由需添加auth:sanctum 中間件，並手動(dòng)調(diào)用tokenCan 方法驗(yàn)證權(quán)限。 4. 登出時(shí)刪除當(dāng)前或所有token，同時(shí)前端需清除保存的token。

Laravel Sanctum 是一個(gè)輕量級(jí)的身份驗(yàn)證系統(tǒng)，特別適合用於構(gòu)建API 認(rèn)證。它不像Passport 那樣複雜，也不需要OAuth 的全套流程，非常適合前後端分離的項(xiàng)目，比如Vue、React 或移動(dòng)端應(yīng)用。

下面是一些關(guān)鍵步驟和注意事項(xiàng)，幫你快速設(shè)置好Laravel Sanctum 的API 認(rèn)證。

1. 安裝與基礎(chǔ)配置

首先確保你已經(jīng)創(chuàng)建了一個(gè)Laravel 項(xiàng)目，並且版本在7.x 以上（推薦使用最新穩(wěn)定版）。

安裝Sanctum：

 composer require laravel/sanctum

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

 php artisan vendor:publish --provider="Laravel\Sanctum\SanctumServiceProvider"

運(yùn)行遷移：

 php artisan migrate

如果你打算用Sanctum 來做SPA 登錄（比如Vue 前端），還需要在config/sanctum.php中設(shè)置允許的域名，並啟用stateful設(shè)置。

2. 用戶登錄與生成Token

Sanctum 支持兩種token 模式：簡(jiǎn)單token和可撤銷的個(gè)性化token 。

如果你只是想做一個(gè)簡(jiǎn)單的登錄接口，可以這樣生成token：

 use Illuminate\Support\Facades\Auth;

$user = Auth::user();
$token = $user->createToken('auth_token')->plainTextToken;

返回這個(gè)token 給前端，之後每次請(qǐng)求帶上Authorization: Bearer {token}即可。

如果你想支持revoke token 或者給不同設(shè)備生成不同權(quán)限的token，可以用：

 $token = $user->createToken('Mobile App', ['read', 'write']);

然後通過$token->plainTextToken獲取值。

3. 保護(hù)你的API 路由

在routes/api.php中，使用auth:sanctum中間件來保護(hù)路由：

 Route::middleware('auth:sanctum')->get('/user', function (Request $request) {
    return $request->user();
});

注意：默認(rèn)情況下Sanctum 不檢查token 是否有特定權(quán)限，除非你手動(dòng)調(diào)用$request->user()->tokenCan('read')來判斷。

4. 登出與Token 註銷

註銷當(dāng)前用戶的token：

 $request->user()->currentAccessToken()->delete();

如果要一次性註銷所有token：

 $request->user()->tokens()->delete();

這些操作都很簡(jiǎn)單，但容易被忽略的是：你需要在前端清除掉保存的token，否則下次請(qǐng)求還是會(huì)帶上舊token。

基本上就這些了。 Sanctum 的設(shè)計(jì)目標(biāo)是簡(jiǎn)單直接，不需要復(fù)雜的配置就能完成API 認(rèn)證。只要注意中間件、token 創(chuàng)建和銷毀這幾個(gè)點(diǎn)，基本不會(huì)踩坑。

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