首页 > 文章 > php教程

手把手教你用PHP实战JWT短期令牌（附详细代码案例）

时间：2025-06-13 13:27:23 494浏览收藏

学习知识要善于思考，思考，再思考！今天golang学习网小编就给大家带来《PHP手把手教你玩转JWT短期令牌（附详细代码）》，以下内容主要包含等知识点，如果你正在学习或准备学习文章，就都不要错过本文啦~让我们一起来看看吧，能帮助到你就更好了！

处理JWT短期令牌的核心在于平衡安全性与用户体验。1. 令牌生成：使用如firebase/php-jwt库，设置合理过期时间（如银行类应用5-15分钟，博客类应用1-2小时）；2. 令牌验证：通过相同密钥验证令牌有效性，过期则拒绝访问；3. 令牌刷新：通过refresh token换取新access token，避免频繁登录，refresh token需存储在HTTP-only cookie中加强安全；4. 存储策略：access token存于localStorage/sessionStorage，refresh token存于HTTP-only cookie；5. 密钥管理：密钥应从环境变量或安全存储（如HashiCorp Vault）获取，防止硬编码泄露风险。

PHP怎样处理JWT短期令牌 JWT短期令牌处理技巧分享

JWT（JSON Web Token）短期令牌的处理，核心在于安全性与用户体验之间的平衡。一方面，我们需要令牌足够短，以降低被盗用后的风险；另一方面，又不能频繁要求用户重新登录，影响用户体验。PHP在处理JWT时，可以结合多种策略来实现这个平衡。

解决方案

PHP处理JWT短期令牌，主要涉及以下几个方面：令牌生成、验证、刷新和存储。

令牌生成： 使用合适的PHP JWT库（例如firebase/php-jwt），设置合理的expiration time（过期时间）。这个时间需要根据应用的敏感程度和用户行为习惯来决定。例如，对于银行类应用，可能只需要几分钟，而对于博客类应用，可以设置几个小时。

use Firebase\JWT\JWT;

$key = "your_secret_key"; // 你的密钥，务必保密
$payload = array(
    "iss" => "your_domain",
    "aud" => "your_domain",
    "iat" => time(),
    "nbf" => time(),
    "exp" => time() + (60 * 5), // 5分钟后过期
    "data" => array(
        "userId" => 123,
        "userName" => "JohnDoe"
    )
);

$jwt = JWT::encode($payload, $key, 'HS256');
echo $jwt;

令牌验证： 在用户访问需要授权的资源时，使用相同的密钥验证令牌的有效性。如果令牌过期，则拒绝访问。

use Firebase\JWT\JWT;
use Firebase\JWT\Key;

$jwt = $_POST['jwt']; // 假设从POST请求中获取JWT
$key = "your_secret_key";

try {
    $decoded = JWT::decode($jwt, new Key($key, 'HS256'));
    // 令牌有效，可以访问资源
    echo "用户ID: " . $decoded->data->userId;
} catch (\Exception $e) {
    // 令牌无效或已过期
    echo "错误: " . $e->getMessage();
}

令牌刷新： 当短期令牌即将过期时，使用refresh token来获取新的短期令牌，而无需用户重新登录。refresh token的有效期可以设置得更长，但需要采取额外的安全措施来保护它，例如存储在HTTP-only的cookie中。
- 颁发refresh token: 在用户登录成功后，除了颁发access token (JWT) 之外，同时颁发一个refresh token。这个refresh token通常是一个随机字符串，存储在数据库中，并与用户ID关联。
- 刷新token的流程: 当access token过期或者即将过期时，客户端将refresh token发送到服务器。服务器验证refresh token的有效性（例如，检查数据库中是否存在该refresh token，以及是否属于该用户）。如果验证通过，则颁发一个新的access token和refresh token。旧的refresh token可以作废，也可以保留一段时间，用于处理网络延迟等情况，但务必设置过期时间。
存储： 短期令牌通常存储在客户端的localStorage或sessionStorage中。refresh token 存储在HTTP-only的cookie中，防止XSS攻击。

PHP JWT库选择与安全性考量

选择一个可靠的PHP JWT库至关重要。firebase/php-jwt 是一个常用的选择，但务必关注其更新和安全性漏洞。另外，密钥的管理也至关重要，切勿将密钥硬编码在代码中，而是应该存储在环境变量或配置文件中。考虑使用更安全的密钥存储方案，例如HashiCorp Vault。

JWT过期时间设置多少合适？

这个没有标准答案，取决于应用场景。对于安全性要求高的应用，比如银行、支付，建议将过期时间设置得很短，例如 5-15 分钟。对于安全性要求不高的应用，比如博客、论坛，可以设置长一些，例如 1-2 小时。关键在于找到一个平衡点，既能保证安全性，又能提供良好的用户体验。

如何防止JWT被篡改？

JWT本身通过签名机制来防止篡改。签名是使用密钥对JWT的头部和载荷进行加密生成的。在验证JWT时，使用相同的密钥重新生成签名，并与JWT中的签名进行比较。如果两个签名不一致，说明JWT已被篡改。所以，保护好你的密钥是防止JWT被篡改的关键。

为什么需要Refresh Token？

如果只使用短期 JWT，用户需要频繁登录，体验很差。如果 JWT 过期时间设置太长，安全性又会降低。Refresh Token 的出现就是为了解决这个矛盾。它允许我们在 JWT 过期后，无需用户重新登录，即可获取新的 JWT，从而提升用户体验，同时保证安全性。可以把refresh token理解为一个“长期有效的通行证”，用于换取短期有效的JWT。

文中关于php,jwt的知识介绍，希望对你的学习有所帮助！若是受益匪浅，那就动动鼠标收藏这篇《手把手教你用PHP实战JWT短期令牌（附详细代码案例）》文章吧，也可关注golang学习网公众号了解相关技术文章。

php jwt