不依赖库的 JWT 实现
HS256 的签发与校验,包含过期、签发时间、签名恒时比较,够用来做中小项目的接口认证。
更新于 2026-11-0950 行代码
完整代码
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];
}
怎么用
- 登录成功后:$token = jwt_sign(['uid' => $id, 'role' => 'user'], $secret);
- 接口入口从 Authorization: Bearer xxx 取令牌,调用 jwt_verify。
- 校验通过后用 $claims['uid'] 查用户,不要直接信任 payload 里的其它字段。
注意
- payload 只是 base64,不是加密,不要放密码、手机号。
- 必须校验 header 里的 alg,否则可能被改成 none 绕过签名。
- JWT 无法主动失效,需要吊销时维护一个短期的黑名单(Redis)。