深入解析lcobucci/jwt项目：如何签发JWT令牌-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_00696/article/details/148464288

深入解析lcobucci/jwt项目：如何签发JWT令牌

jwt A simple library to work with JSON Web Token and JSON Web Signature 项目地址: https://gitcode.com/gh_mirrors/jw/jwt

前言

在现代Web开发中，JSON Web Token（JWT）已成为身份验证和授权的主流方案。lcobucci/jwt是一个功能强大且灵活的PHP库，专门用于处理JWT的创建、解析和验证。本文将重点介绍如何使用lcobucci/jwt库签发JWT令牌。

JWT基础概念

JWT由三部分组成，用点号(.)分隔：

Header（头部）：包含令牌类型和签名算法
Payload（负载）：包含声明（claims），即有关实体（通常是用户）和其他数据的声明
Signature（签名）：用于验证消息在传输过程中没有被篡改

初始化令牌构建器

要签发新令牌，首先需要创建令牌构建器：

use Lcobucci\JWT\Encoding\ChainedFormatter;
use Lcobucci\JWT\Encoding\JoseEncoder;
use Lcobucci\JWT\Token\Builder;

$tokenBuilder = Builder::new(new JoseEncoder(), ChainedFormatter::default());

这里使用了两个重要组件：

JoseEncoder：负责JWT的编码和解码
ChainedFormatter：控制JWT声明的格式化方式

配置签名算法和密钥

JWT的安全性依赖于签名算法和密钥。lcobucci/jwt支持多种算法，这里以HMAC-SHA256为例：

use Lcobucci\JWT\Signer\Hmac\Sha256;
use Lcobucci\JWT\Signer\Key\InMemory;

$algorithm = new Sha256();
$signingKey = InMemory::plainText(random_bytes(32));

InMemory类提供了多种创建密钥的方式，plainText方法直接从字符串创建密钥。实际生产环境中，密钥应该从安全的位置加载，而不是硬编码在代码中。

设置标准声明

JWT规范定义了一些标准声明（claims），这些声明虽然不是强制性的，但被广泛采用：

$now = new DateTimeImmutable();

$token = $tokenBuilder
    ->issuedBy('http://example.com')       // iss: 签发者
    ->permittedFor('http://example.org')   // aud: 目标受众
    ->relatedTo('component1')              // sub: 主题
    ->identifiedBy('4f1g23a12aa')          // jti: 令牌唯一标识符
    ->issuedAt($now)                       // iat: 签发时间
    ->canOnlyBeUsedAfter(                  // nbf: 生效时间
        $now->modify('+1 minute')
    )
    ->expiresAt($now->modify('+1 hour'));  // exp: 过期时间

添加自定义声明和头部

除了标准声明，还可以添加自定义声明和头部：

$token = $tokenBuilder
    ->withClaim('uid', 1)      // 自定义声明
    ->withHeader('foo', 'bar') // 自定义头部
    ->getToken($algorithm, $signingKey);

获取和使用令牌

构建完成后，可以获取令牌的各个部分：

// 获取头部和声明
$token->headers();  // 返回头部数组
$token->claims();   // 返回声明数组

// 获取特定值
echo $token->headers()->get('foo'); // 输出 "bar"
echo $token->claims()->get('iss');  // 输出 "http://example.com"

// 获取JWT字符串表示
echo $token->toString();