PHP怎样处理JWT令牌处理JWT令牌的5个安全要点-php教程-PHP中文网

PHP怎样处理JWT令牌处理JWT令牌的5个安全要点

冰火之心

发布： 2025-06-25 16:32:02

原创

358人浏览过

php处理jwt需选成熟库如firebase/php-jwt，1.使用环境变量存储密钥；2.通过jwt::encode生成令牌；3.用jwt::decode验证签名及有效期；4.传输时采用authorization头；5.结合刷新令牌机制延长访问周期；6.防篡改依赖签名与https；7.撤销可通过黑名单或删除刷新令牌实现。

PHP怎样处理JWT令牌处理JWT令牌的5个安全要点

PHP处理JWT令牌的关键在于安全、验证和管理。它涉及到解析、验证签名、提取信息，以及确保令牌在整个生命周期内的安全。

解决方案

选择合适的JWT库： 不要自己造轮子。使用成熟、经过良好测试的PHP JWT库，例如firebase/php-jwt。这些库已经处理了大部分的底层细节，并提供了安全措施。

立即学习“PHP免费学习笔记（深入）”；
```
use Firebase\JWT\JWT;
use Firebase\JWT\Key;

require_once 'vendor/autoload.php'; // 确保已安装库
```
登录后复制

生成JWT： 你需要一个密钥（secret key），用于签名JWT。务必将此密钥保密，不要硬编码在代码中！ 可以使用环境变量或配置文件。

$key = $_ENV['JWT_SECRET_KEY']; // 从环境变量获取密钥
$payload = array(
    "iss" => "your-domain.com", // 发行者
    "aud" => "your-domain.com", // 接收者
    "iat" => time(),           // Issued At Time
    "nbf" => time(),           // Not Before Time
    "exp" => time() + (60*60),  // Expire Time (1 hour)
    "data" => array(            // 自定义数据
        "userId" => 123,
        "userName" => "John Doe"
    )
);

$jwt = JWT::encode($payload, $key, 'HS256'); // 使用HS256算法签名
echo $jwt;

登录后复制

验证JWT： 当客户端发送JWT时，你需要验证它的有效性。这包括验证签名、检查过期时间等。

try {
    $decoded = JWT::decode($jwt, new Key($key, 'HS256'));
    print_r($decoded);

    // 现在你可以访问JWT中的数据
    $userId = $decoded->data->userId;
    $userName = $decoded->data->userName;

} catch (\Exception $e) {
    // 令牌无效
    http_response_code(401); // Unauthorized
    echo json_encode(array("message" => "Invalid JWT. " . $e->getMessage()));
}

登录后复制

存储和传输JWT： 通常，JWT会存储在客户端的localStorage或cookie中。在传输时，建议使用Authorization头，格式为Bearer 。
```
Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...
```
登录后复制
刷新令牌： 为了提高安全性，JWT通常具有较短的过期时间。可以使用刷新令牌（refresh token）机制，在JWT过期后，使用刷新令牌获取新的JWT，而无需用户重新登录。这需要额外的逻辑来管理刷新令牌的存储和验证。

如何选择合适的JWT库？

选择JWT库时，要考虑几个关键因素。首先是它的安全性：它是否经过安全审计，是否有已知的漏洞？其次是它的活跃程度：库是否还在维护，是否有活跃的社区？最后是它的易用性：API是否清晰，文档是否完整？ firebase/php-jwt是一个广泛使用的选择，因为它相对安全、易于使用，并且有良好的文档。然而，也要关注其他的库，并根据你的具体需求进行选择。