不依赖会话的 CSRF 令牌
时间戳加 HMAC 签名,页面被缓存、会话丢失也不会失效;校验用 hash_equals,防止时序攻击。
更新于 2026-11-0320 行代码
完整代码
PHP
<?php
function csrf_token(string $secret, int $ttl = 86400): string
{
$ts = time();
$sig = substr(hash_hmac('sha256', 'csrf|' . $ts, $secret), 0, 26);
return $ts . '.' . $sig;
}
function csrf_check(string $token, string $secret, int $ttl = 86400): bool
{
if (!preg_match('/^(\d{10})\.([a-f0-9]{26})$/', $token, $m)) {
return false;
}
$ts = (int)$m[1];
if ($ts > time() + 120 || time() - $ts > $ttl) {
return false;
}
$expect = substr(hash_hmac('sha256', 'csrf|' . $ts, $secret), 0, 26);
return hash_equals($expect, $m[2]);
}
怎么用
- 表单里放 <input type="hidden" name="csrf" value="<?= csrf_token($secret) ?>">。
- 提交后 csrf_check($_POST['csrf'], $secret),不通过直接 403。
- 所有写操作(增删改、支付、改密)都要校验,读接口不需要。
注意
- 这种令牌不绑定会话,所以同一秒生成的令牌是相同的,安全性略低于会话绑定版本,但胜在被缓存也不会失效。
- 密钥必须放在 Web 根目录之外,不能进版本库。
- 配合 SameSite=Lax 的会话 Cookie,能覆盖绝大多数 CSRF 场景。