源码系统概览
文章正文
JWT Webman 是一套兼容 webman、Laravel、ThinkPHP 与 Hyperf 的 JWT 认证组件源码，以一套核心加框架适配层解决多框架微服务间认证逻辑不一致问题。
项目作者为开发者 erik，MIT 协议开源，核心基于 firebase JWT 库构建，核心包可用于 PHP 7.4 以上任意项目，README 最后更新 2026 年，附四框架安装命令。
源码简介
令牌签名支持 HS256 家族与 RS256 非对称算法，验证支持时间容差配置，刷新令牌延长会话生命周期。
黑名单提供文件、Redis、数据库与缓存四种可插拔存储驱动，存储故障自动优雅降级不影响主流程。
存储操作内置自动重试装饰器，便捷封装可自动从请求头提取 Bearer 令牌减少样板代码。
四框架深度集成各提供安装命令、中间件与服务注册，Hyperf 还支持注解式鉴权声明。
和直接使用 firebase JWT 库对比，区别在于 JWT Webman 补齐黑名单、刷新令牌与多框架集成层。
| 对比维度 | JWT Webman | Firebase JWT |
|---|---|---|
| 框架适配 | 四大框架安装即用 | 纯库需自行封装 |
| 黑名单 | 四驱动可插拔加降级 | 需自行实现 |
| 刷新令牌 | 内置完整流程 | 自行设计 |
| 运维工具 | 安装命令加自动重试 | 无配套 |
多框架微服务体系要统一接口鉴权，这个组件一套配置覆盖四框架无差别接入。
适用场景
- 微服务网关做统一令牌签发与校验。
- 前后端分离项目做无状态接口鉴权。
- 多框架技术栈统一认证中间件。
- 学习 JWT 黑名单与刷新令牌工程实现。
技术栈与运行环境
核心包零框架依赖可用于 PHP 7.4 以上任意项目，签名算法覆盖 HS 家族与 RS256 非对称。
适配 webman 1 与 2、Laravel 服务自动发现、ThinkPHP 服务注册与 Hyperf 注解鉴权。
安装执行 composer require 后按框架运行安装命令，配置密钥与黑名单存储驱动即可。
功能亮点
- 一套核心加适配层覆盖四大框架。
- HS 家族加 RS256 双算法签名。
- 刷新令牌加时间容差校验。
- 黑名单四驱动可插拔加故障降级。
- 便捷封装自动提取 Bearer 令牌。
技术架构与部署指南
安装与部署提示
执行 composer require erikwang2013/jwt-webman 完成安装，各框架按文档运行安装命令发布配置。
配置签名密钥至少十六位字符并选择黑名单存储驱动，业务路由挂载鉴权中间件即可生效。
包内代码对应 v1.1.0 口径版本，更新日志以仓库提交记录为准，最后更新 2026 年 8 月。
截图与演示说明
项目 README 以四框架接入说明与打赏码为主，未附界面截图，本页配图采用 GitHub 仓库社交分享卡片。
组件为代码库形态，接入后调用验证接口即可确认鉴权链路生效。
配置密钥后调用签发方法生成令牌，受保护接口未携带令牌即返回未授权响应。
常见问题
问. JWT Webman 是什么组件？
一套兼容四大框架的 JWT 认证组件源码，签名校验、刷新令牌与黑名单一体，核心基于 firebase JWT 库，MIT 协议开源。
问. 怎么安装使用？
composer require 安装后按框架运行安装命令，配置密钥与存储驱动，路由挂载中间件即可完成鉴权。
问. 和 Firebase JWT 库有什么区别？
Firebase JWT 是纯签名校验库，本组件补齐刷新令牌、黑名单四驱动、自动重试与四框架集成层。
问. 常驻内存框架要注意什么？
webman 与 Hyperf 常驻进程下自动清理不随请求触发，需用框架定时器定期调用清理方法。
安全风险提示
对 68 个源码文件做了扫描，代码明文无加密混淆，未发现 webshell 与凭据硬编码。
JWT 编解码调用属标准流程，测试目录的高风险函数命中为用例代码。
签名密钥请通过环境变量注入且长度不低于十六位，避免使用弱密钥。
下载说明
本页提供 JWT Webman 认证组件完整源码打包下载，含核心与四框架适配层。
压缩包内附各框架安装说明，解压后按文档配置即可接入业务。
GitHub项目开源地址 https://github.com/erikwang2013/jwt-webman
