如何用PHP实现JWT？Token认证完整实现-php教程-PHP中文网

如何用PHP实现JWT？Token认证完整实现

看不見的法師

发布： 2025-07-08 11:17:01

原创

823人浏览过

要使用php实现jwt认证，首先要安装firebase/php-jwt库；接着构造payload并用密钥签名生成token；然后通过验证token确保请求合法性；最后结合登录流程合理管理token生命周期。具体步骤为：1. 通过composer安装firebase/php-jwt依赖；2. 使用jwt::encode()方法生成包含iss、aud、iat、exp等字段的token；3. 使用jwt::decode()方法解析并验证token，捕获异常处理错误；4. 登录成功后返回token，前端存储并在后续请求中携带，后端接口统一验证token有效性；5. 建议设置合理过期时间、使用https传输、避免敏感信息、采用配置管理密钥并可选黑名单机制提升安全性。

如何用PHP实现JWT？Token认证完整实现

JWT（JSON Web Token）是一种常用于前后端分离项目中的身份验证机制。用PHP实现JWT认证并不复杂，只要掌握几个关键步骤，就可以快速搭建起一个安全、高效的认证流程。

准备工作：安装依赖

PHP中实现JWT最常用的库是 firebase/php-jwt，它封装了JWT的生成和验证过程。你可以通过 Composer 来安装：

composer require firebase/php-jwt

登录后复制

安装完成后，在你的PHP文件中引入该库即可开始使用。

立即学习“PHP免费学习笔记（深入）”；

生成Token：设置有效载荷和签名

生成JWT的过程包括构造payload（有效载荷）并使用密钥签名。以下是一个基本示例：

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

$key = "your_secret_key"; // 密钥建议足够复杂，并放在配置中
$payload = [
    'iss' => 'http://example.com', // 签发者
    'aud' => 'http://example.org', // 接收方
    'iat' => time(),                // 签发时间
    'exp' => time() + 3600,         // 过期时间
    'data' => [
        'user_id' => 123,
        'username' => 'test_user'
    ]
];

$jwt = JWT::encode($payload, $key, 'HS256');
echo "Generated Token: " . $jwt;

登录后复制

几点建议：

使用 HS256 或 RS256 算法都可以，根据实际需要选择
密钥不要硬编码在代码里，推荐从环境变量或配置文件中读取
payload 中尽量避免敏感信息，如密码等

验证Token：确保合法性与安全性

收到客户端传来的token后，需要进行解析和验证。这一步可以防止伪造请求和过期token的使用。

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

$jwt = $_SERVER['HTTP_AUTHORIZATION'] ?? ''; // 假设token在header中传递
$key = "your_secret_key";

try {
    $decoded = JWT::decode($jwt, new Key($key, 'HS256'));
    echo json_encode((array)$decoded);
} catch (\Exception $e) {
    http_response_code(401);
    echo json_encode(['error' => $e->getMessage()]);
}

登录后复制

需要注意的地方：