0

0

ThinkPHP的JWT认证怎么用?ThinkPHP如何实现无状态认证?

幻夢星雲

幻夢星雲

发布时间:2025-07-30 16:29:01

|

941人浏览过

|

来源于php中文网

原创

thinkphp中使用jwt认证的核心是生成和验证token,以实现无状态的api认证;2. 首先通过composer安装firebase/php-jwt库,并在config/jwt.php中配置密钥、算法、签发者、接收者和有效期等参数;3. 用户登录成功后调用generatetoken方法,使用hs256算法和配置密钥生成包含用户信息的jwt token;4. 创建jwtauth中间件,在每次请求时从authorization头中获取token,解码并验证其有效性,将用户信息存入request对象供控制器使用;5. 在middleware.php中注册中间件并在需要保护的路由组中应用jwt_auth中间件;6. token过期后可通过refresh token机制或无感刷新机制获取新token,前者更安全后者体验更佳;7. 防止jwt被篡改需使用强密钥、https传输、避免存储敏感信息、定期更换密钥并验证签发者和接收者;8. 最佳实践包括使用中间件统一处理认证、将用户信息存入request或缓存、记录token操作日志,并可考虑集成tymon/jwt-auth等成熟库提升开发效率;9. 加密算法推荐根据安全与性能需求选择hs256(对称加密,性能好)或rs256(非对称加密,安全性高),优先在高安全场景使用rs256并确保密钥管理安全。

ThinkPHP的JWT认证怎么用?ThinkPHP如何实现无状态认证?

ThinkPHP中使用JWT认证,核心在于生成和验证token,从而实现无状态的API接口认证。它允许你摆脱session的束缚,让服务器不再需要记住客户端的状态,极大地提升了可扩展性和安全性。

ThinkPHP的JWT认证怎么用?ThinkPHP如何实现无状态认证?

解决方案:

  1. 安装JWT库: 推荐使用 firebase/php-jwt,通过composer安装:

    立即学习PHP免费学习笔记(深入)”;

    ThinkPHP的JWT认证怎么用?ThinkPHP如何实现无状态认证?
    composer require firebase/php-jwt
  2. 配置JWT: 在ThinkPHP的配置文件中(例如 config/jwt.php),定义JWT相关的参数,例如密钥、token有效期等。

    <?php
    
    return [
        'key' => 'your_secret_key', // 必须修改成自己的密钥
        'alg' => 'HS256', // 加密算法
        'iss' => 'your_domain.com', // 签发者
        'aud' => 'your_domain.com', // 接收者
        'exp' => 7200, // token有效期,单位秒
    ];
  3. 生成Token: 创建一个方法来生成JWT token。 通常在用户登录成功后调用。

    ThinkPHP的JWT认证怎么用?ThinkPHP如何实现无状态认证?
    use Firebase\JWT\JWT;
    
    function generateToken($user) {
        $key = config('jwt.key');
        $payload = array(
            "iss" => config('jwt.iss'),
            "aud" => config('jwt.aud'),
            "iat" => time(),
            "nbf" => time(),
            "exp" => time() + config('jwt.exp'),
            "data" => [                  //用户信息
                'userId' => $user['id'],
                'username' => $user['username'],
                'email' => $user['email']
            ]
        );
    
        return JWT::encode($payload, $key, config('jwt.alg'));
    }
  4. 验证Token: 创建一个中间件来验证JWT token。 每次请求API接口时都会经过这个中间件。

    <?php
    
    namespace app\middleware;
    
    use Closure;
    use Firebase\JWT\JWT;
    use Firebase\JWT\Key;
    
    class JwtAuth
    {
        public function handle($request, Closure $next)
        {
            $token = $request->header('Authorization'); // 从请求头获取token
    
            if (!$token) {
                return json(['code' => 401, 'msg' => 'Unauthorized: Missing token']);
            }
    
            try {
                $key = config('jwt.key');
                $decoded = JWT::decode($token, new Key($key, config('jwt.alg')));
                $request->user = $decoded->data;  // 将用户信息放入request对象
    
                return $next($request);
    
            } catch (\Exception $e) {
                return json(['code' => 401, 'msg' => 'Unauthorized: Invalid token', 'error' => $e->getMessage()]);
            }
        }
    }
  5. 注册中间件:middleware.php 文件中注册该中间件。

    <?php
    
    return [
        'jwt_auth' => \app\middleware\JwtAuth::class,
    ];
  6. 应用中间件: 在需要进行JWT认证的路由中,应用该中间件。

    mallcloud商城
    mallcloud商城

    mallcloud商城基于SpringBoot2.x、SpringCloud和SpringCloudAlibaba并采用前后端分离vue的企业级微服务敏捷开发系统架构。并引入组件化的思想实现高内聚低耦合,项目代码简洁注释丰富上手容易,适合学习和企业中使用。真正实现了基于RBAC、jwt和oauth2的无状态统一权限认证的解决方案,面向互联网设计同时适合B端和C端用户,支持CI/CD多环境部署,并提

    下载
    Route::group(function () {
        Route::get('user/profile', 'UserController/profile');
    })->middleware('jwt_auth');

JWT Token过期后如何刷新?

Token过期后,通常有两种刷新方式:

  • 使用Refresh Token: 在生成Token时,同时生成一个Refresh Token。 当Token过期后,客户端使用Refresh Token向服务器请求新的Token。 这种方式安全性较高,但实现起来稍微复杂。 需要维护Refresh Token的存储和状态。

  • 无感刷新: 在Token即将过期时,客户端自动向服务器请求新的Token。 这种方式对用户体验友好,但需要前端配合。 需要注意并发请求的问题,避免多次刷新Token。 具体实现可以监听接口返回的状态码,如果返回token失效的状态码,就自动调用刷新token的接口。

如何防止JWT被篡改?

JWT本身已经包含了签名,可以防止被篡改。 但仍然需要注意以下几点:

  • 使用强密钥: 密钥必须足够复杂,不易被破解。
  • 使用HTTPS: 防止Token在传输过程中被截获。
  • 不要在Token中存储敏感信息: Token中的信息可以被解码,所以不要存储密码等敏感信息。
  • 定期更换密钥: 定期更换密钥可以提高安全性。
  • 验证Token的签发者和接收者: 确保Token是由可信的签发者签发的,并且是发送给正确的接收者。

ThinkPHP中JWT认证的最佳实践是什么?

  • 使用中间件进行统一认证: 将JWT认证逻辑封装成中间件,方便在多个路由中使用。
  • 在请求对象中存储用户信息: 将解码后的用户信息存储在请求对象中,方便在控制器中使用。
  • 使用缓存存储用户信息: 将用户信息存储在缓存中,可以减少数据库查询次数。
  • 记录Token的日志: 记录Token的生成、刷新和失效等事件,方便审计。
  • 考虑使用现成的JWT库: 例如 tymon/jwt-auth,它提供了更完善的JWT认证功能。 虽然这个库可能不是 firebase/php-jwt,但它针对Laravel/ThinkPHP做了优化,集成度更高。 需要注意的是,它可能需要一些额外的配置,但能简化不少工作。

选择哪种加密算法更安全?

通常推荐使用 HS256RS256HS256 是对称加密算法,速度快,但安全性相对较低。 RS256 是非对称加密算法,安全性高,但速度较慢。 具体选择哪种算法,需要根据实际情况进行权衡。 通常来说,对于安全性要求较高的场景,推荐使用 RS256。 如果对性能要求较高,可以使用 HS256,但需要确保密钥的安全性。 同时,也要关注最新的安全漏洞和攻击方式,及时更新JWT库和加密算法。

相关文章

PHP速学教程(入门到精通)
PHP速学教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
laravel组件介绍
laravel组件介绍

laravel 提供了丰富的组件,包括身份验证、模板引擎、缓存、命令行工具、数据库交互、对象关系映射器、事件处理、文件操作、电子邮件发送、队列管理和数据验证。想了解更多laravel的相关内容,可以阅读本专题下面的文章。

339

2024.04.09

laravel中间件介绍
laravel中间件介绍

laravel 中间件分为五种类型:全局、路由、组、终止和自定。想了解更多laravel中间件的相关内容,可以阅读本专题下面的文章。

293

2024.04.09

laravel使用的设计模式有哪些
laravel使用的设计模式有哪些

laravel使用的设计模式有:1、单例模式;2、工厂方法模式;3、建造者模式;4、适配器模式;5、装饰器模式;6、策略模式;7、观察者模式。想了解更多laravel的相关内容,可以阅读本专题下面的文章。

772

2024.04.09

thinkphp和laravel哪个简单
thinkphp和laravel哪个简单

对于初学者来说,laravel 的入门门槛较低,更易上手,原因包括:1. 更简单的安装和配置;2. 丰富的文档和社区支持;3. 简洁易懂的语法和 api;4. 平缓的学习曲线。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

385

2024.04.10

laravel入门教程
laravel入门教程

本专题整合了laravel入门教程,想了解更多详细内容,请阅读专题下面的文章。

140

2025.08.05

laravel实战教程
laravel实战教程

本专题整合了laravel实战教程,阅读专题下面的文章了解更多详细内容。

85

2025.08.05

laravel面试题
laravel面试题

本专题整合了laravel面试题相关内容,阅读专题下面的文章了解更多详细内容。

80

2025.08.05

PHP高性能API设计与Laravel服务架构实践
PHP高性能API设计与Laravel服务架构实践

本专题围绕 PHP 在现代 Web 后端开发中的高性能实践展开,重点讲解基于 Laravel 框架构建可扩展 API 服务的核心方法。内容涵盖路由与中间件机制、服务容器与依赖注入、接口版本管理、缓存策略设计以及队列异步处理方案。同时结合高并发场景,深入分析性能瓶颈定位与优化思路,帮助开发者构建稳定、高效、易维护的 PHP 后端服务体系。

429

2026.03.04

C# ASP.NET Core微服务架构与API网关实践
C# ASP.NET Core微服务架构与API网关实践

本专题围绕 C# 在现代后端架构中的微服务实践展开,系统讲解基于 ASP.NET Core 构建可扩展服务体系的核心方法。内容涵盖服务拆分策略、RESTful API 设计、服务间通信、API 网关统一入口管理以及服务治理机制。通过真实项目案例,帮助开发者掌握构建高可用微服务系统的关键技术,提高系统的可扩展性与维护效率。

3

2026.03.11

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

相关下载

更多

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号