首先安装 tymon/jwt-auth 包并注册服务提供者,接着生成配置文件与密钥,然后修改 auth 配置使用 jwt 驱动,用户模型实现 JWTSubject 接口,创建登录登出接口处理 Token 生成与销毁,通过 auth:api 中间件保护路由,并可刷新 Token 以延长有效期,完成 laravel JWT 认证体系搭建。

在 Laravel 中实现 JWT(jsON Web Tokens)认证,通常使用 tymon/jwt-auth 这个广泛支持的扩展包。它可以帮助你快速搭建基于 Token 的用户认证系统,适用于 API 开发场景。
安装 jwt-auth 扩展包
在 Laravel 项目根目录下运行以下命令来安装 JWT 认证包:
安装完成后,如果你使用的是 Laravel 8 及以上版本,需要手动注册服务提供者(Laravel 9+ 可能不需要):
'providers' => [ ... TymonJWTAuthProvidersLaravelServiceProvider::class, ],
'aliases' => [ ... 'JWTAuth' => TymonJWTAuthFacadesJWTAuth::class, 'JWTFactory' => TymonJWTAuthFacadesJWTFactory::class, ],
生成 JWT 配置文件
运行以下命令生成配置文件和密钥:
然后生成 JWT 的 secret key:
php artisan jwt:secret
这会在 .env 文件中自动添加一行:
JWT_SECRET=your_random_string
配置 auth.php 支持 JWT
修改 config/auth.php,将 API 认证驱动改为 jwt:
Easily find json paths within JSON objects using our intuitive Json Path Finder
30
'guards' => [ 'web' => [ 'driver' => 'session', 'provider' => 'users', ], 'api' => [ 'driver' => 'jwt', 'provider' => 'users', ], ],
在 User 模型中使用 JWTSubject
确保你的 User 模型实现了 JWTSubject 接口:
use TymonJWTAuthContractsJWTSubject; class User extends Authenticatable implements JWTSubject { // ... public function getJWTIdentifier() { return $this->getKey(); } public function getJWTCustomClaims() { return []; } }
创建登录和登出接口
在控制器中处理登录并返回 Token:
use TymonJWTAuthFacadesJWTAuth; use TymonJWTAuthExceptionsJWTException; class AuthController extends Controller { public function login(Request $request) { $credentials = $request->only('email', 'password'); try { if (! $token = JWTAuth::attempt($credentials)) { return response()->json(['error' => 'invalid_credentials'], 401); } } catch (JWTException $e) { return response()->json(['error' => 'could_not_create_token'], 500); } return response()->json(compact('token')); } public function logout() { JWTAuth::invalidate(JWTAuth::getToken()); return response()->json(['message' => 'Successfully logged out']); } }
保护路由
在 routes/api.php 中使用中间件保护 API 路由:
Route::group(['middleware' => 'auth:api'], function () { Route::get('/user', function () { return auth()->user(); }); Route::post('/logout', [AuthController::class, 'logout']); });
登录接口无需保护,其他敏感接口加上 auth:api 中间件即可自动验证 Token。
处理 Token 刷新与过期
你可以通过以下方式刷新 Token(延长有效期):
public function refresh() { try { $newToken = JWTAuth::refresh(); } catch (JWTException $e) { return response()->json(['error' => 'cannot_refresh_token'], 500); } return response()->json(compact('newToken')); }
默认 Token 有效期在 config/jwt.php 中配置,如 'ttl' => 60 表示 60 分钟过期。
基本上就这些。按照步骤操作,就能在 Laravel 中成功实现 JWT 认证。注意生产环境要妥善管理 Token 生命周期和安全性。
以上就是laravel如何实现JWT (JSON Web Tokens)认证_Laravel JWT认证实现方法的详细内容,更多请关注php中文网其它相关文章!
