写给愿意动手的 PHP 开发者
PHP学习网 PHP学习网
公告PHP学习网为公益性网站,致力于为广大PHP爱好者服务
首页/ PHP 源码/ 不依赖会话的 CSRF 令牌
安全相关 通用 PHP 7.4+

不依赖会话的 CSRF 令牌

时间戳加 HMAC 签名,页面被缓存、会话丢失也不会失效;校验用 hash_equals,防止时序攻击。

完整代码

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]);
}

怎么用

  1. 表单里放 <input type="hidden" name="csrf" value="<?= csrf_token($secret) ?>">。
  2. 提交后 csrf_check($_POST['csrf'], $secret),不通过直接 403。
  3. 所有写操作(增删改、支付、改密)都要校验,读接口不需要。

注意

  • 这种令牌不绑定会话,所以同一秒生成的令牌是相同的,安全性略低于会话绑定版本,但胜在被缓存也不会失效。
  • 密钥必须放在 Web 根目录之外,不能进版本库。
  • 配合 SameSite=Lax 的会话 Cookie,能覆盖绝大多数 CSRF 场景。

相关源码