文件版接口限流
没有 Redis 时也能用的滑动窗口限流:按 IP 和接口名分文件,记录时间戳,超过阈值返回 429。
更新于 2026-11-0540 行代码
完整代码
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))];
}
怎么用
- $key = 'login:' . client_ip(); [$ok, $left] = rate_limit($key, 10, 60);
- 不通过时返回 429,并加 Retry-After 头。
- 按「接口 + IP」或「接口 + 用户 ID」组合,粒度更合理。
注意
- flock 在 NFS 上不可靠,多机部署必须换 Redis。
- 临时目录可能被清理,限流计数会重置,所以它只适合兜底。
- 文件数会随 IP 增长,要配一个定时清理脚本删掉过期文件。