写给愿意动手的 PHP 开发者
PHP学习网 PHP学习网
公告PHP学习网为公益性网站,致力于为广大PHP爱好者服务
首页/ PHP 源码/ 不依赖库的 JWT 实现
网络与接口 进阶 PHP 7.4+

不依赖库的 JWT 实现

HS256 的签发与校验,包含过期、签发时间、签名恒时比较,够用来做中小项目的接口认证。

完整代码

PHP
<?php
function b64url(string $data): string
{
    return rtrim(strtr(base64_encode($data), '+/', '-_'), '=');
}

function b64url_decode(string $data): string
{
    return base64_decode(strtr($data, '-_', '+/'), true) ?: '';
}

function jwt_sign(array $payload, string $secret, int $ttl = 7200): string
{
    $payload['iat'] = time();
    $payload['exp'] = time() + $ttl;

    $h = b64url(json_encode(['alg' => 'HS256', 'typ' => 'JWT']));
    $p = b64url(json_encode($payload, JSON_UNESCAPED_UNICODE));
    $s = b64url(hash_hmac('sha256', $h . '.' . $p, $secret, true));

    return $h . '.' . $p . '.' . $s;
}

function jwt_verify(string $token, string $secret): array
{
    $parts = explode('.', $token);
    if (count($parts) !== 3) {
        return [false, '令牌格式不对'];
    }
    [$h, $p, $s] = $parts;

    $expect = b64url(hash_hmac('sha256', $h . '.' . $p, $secret, true));
    if (!hash_equals($expect, $s)) {
        return [false, '签名无效'];
    }

    $header = json_decode(b64url_decode($h), true);
    if (($header['alg'] ?? '') !== 'HS256') {
        return [false, '算法不被接受'];
    }

    $claims = json_decode(b64url_decode($p), true);
    if (!is_array($claims)) {
        return [false, '载荷解析失败'];
    }
    if (($claims['exp'] ?? 0) < time()) {
        return [false, '令牌已过期'];
    }
    return [true, $claims];
}

怎么用

  1. 登录成功后:$token = jwt_sign(['uid' => $id, 'role' => 'user'], $secret);
  2. 接口入口从 Authorization: Bearer xxx 取令牌,调用 jwt_verify。
  3. 校验通过后用 $claims['uid'] 查用户,不要直接信任 payload 里的其它字段。

注意

  • payload 只是 base64,不是加密,不要放密码、手机号。
  • 必须校验 header 里的 alg,否则可能被改成 none 绕过签名。
  • JWT 无法主动失效,需要吊销时维护一个短期的黑名单(Redis)。

相关源码