写给愿意动手的 PHP 开发者
PHP学习网 PHP学习网
公告PHP学习网为公益性网站,致力于为广大PHP爱好者服务
首页/ PHP 源码/ 文件版接口限流
安全相关 通用 PHP 7.4+

文件版接口限流

没有 Redis 时也能用的滑动窗口限流:按 IP 和接口名分文件,记录时间戳,超过阈值返回 429。

完整代码

PHP
<?php
function rate_limit(string $key, int $limit = 60, int $window = 60): array
{
    $dir = sys_get_temp_dir() . '/rl';
    if (!is_dir($dir)) {
        @mkdir($dir, 0700, true);
    }
    $file = $dir . '/' . sha1($key) . '.json';

    $fh = fopen($file, 'c+');
    if ($fh === false) {
        return [true, 0];                   // 拿不到锁就放行,避免影响业务
    }
    flock($fh, LOCK_EX);

    $raw = stream_get_contents($fh);
    $hits = $raw ? json_decode($raw, true) : [];
    if (!is_array($hits)) {
        $hits = [];
    }

    $now = time();
    $hits = array_values(array_filter($hits, function ($t) use ($now, $window) {
        return $t > $now - $window;
    }));

    $allowed = count($hits) < $limit;
    if ($allowed) {
        $hits[] = $now;
    }

    ftruncate($fh, 0);
    rewind($fh);
    fwrite($fh, json_encode($hits));
    fflush($fh);
    flock($fh, LOCK_UN);
    fclose($fh);

    return [$allowed, max(0, $limit - count($hits))];
}

怎么用

  1. $key = 'login:' . client_ip(); [$ok, $left] = rate_limit($key, 10, 60);
  2. 不通过时返回 429,并加 Retry-After 头。
  3. 按「接口 + IP」或「接口 + 用户 ID」组合,粒度更合理。

注意

  • flock 在 NFS 上不可靠,多机部署必须换 Redis。
  • 临时目录可能被清理,限流计数会重置,所以它只适合兜底。
  • 文件数会随 IP 增长,要配一个定时清理脚本删掉过期文件。

相关源码