在ThinkPHP6中实现JWT身份验证的完整指南

gitbox 2025-07-14

什么是JWT？

JWT（JSON Web Token）是一种用于在网络应用之间传递安全信息的加密令牌。它以JSON对象的形式在客户端和服务器之间安全地传输信息。

JWT的工作原理

JWT由三个部分组成：Header（头部）、Payload（负载）和Signature（签名）。

Header：声明了令牌的类型和加密算法。示例：

{
  "alg": "HS256",
  "typ": "JWT"
}

Payload：包含了一些标准声明和自定义声明。示例：

{
  "sub": "1234567890",
  "name": "John Doe",
  "iat": 1516239022
}

Signature：通过将Header和Payload的Base64编码与一个密钥进行签名生成。

在ThinkPHP6中使用JWT验证的步骤

安装JWT扩展

在ThinkPHP6中使用JWT验证，首先需要安装JWT扩展。在项目目录下的composer.json文件中，添加如下依赖：

"require": {
  "firebase/php-jwt": "5.0.0"
}

然后运行composer install命令来安装JWT扩展。

生成Token

在登录成功后，我们可以生成一个Token，并将其返回给客户端。示例代码：

use think\jwt\JWT;

public function login() {
  // 登录逻辑
  $payload = [
    'sub' => $user->id,
    'name' => $user->username,
    'iat' => time()
  ];
  $token = JWT::encode($payload, $key);
  return json(['token' => $token]);
}

验证Token

在需要验证用户身份的地方，可以使用JWT来验证Token的有效性。示例代码：

use think\jwt\JWT;

public function getUser(Request $request) {
  $token = $request->header('Authorization');
  try {
    $payload = JWT::decode($token, $key, ['HS256']);
    $user = User::get($payload->sub);  // 从数据库中获取用户信息
    return json($user);
  } catch (Exception $e) {
    return json(['error' => 'Token is invalid']);
  }
}

总结

JWT是一种便捷且安全的身份验证方式，在ThinkPHP6中实现JWT验证也非常简单。通过生成和验证Token的过程，可以有效保护用户身份安全。同时，保护好秘钥以及合理设置Token的过期时间，可以进一步增强系统安全性。