FrankenPHP 不内置 IP 限流功能，需在前置反向代理（如 Nginx/Caddy）中实现漏桶限流；次选 PHP 层基于 Redis 的轻量限流；高级方案依赖 Worker 模式或兼容框架，且必须正确配置可信代理以获取真实客户端 IP。
FrankenPHP 本身不内置 IP 请求频率限制功能，它作为基于 PHP 的现代 SAPI（替代传统 FPM），核心职责是高效执行 PHP 脚本，不提供类似 Nginx 的 limit_req 或 Apache 的 mod_evasive 那样的原生限流能力。要实现单 IP 请求频率限制，必须在 FrankenPHP 前置或集成层完成——关键在于：限流必须发生在请求进入 PHP 执行前，否则恶意流量已消耗 CPU 和内存资源，防护就晚了。
以下三种方式按推荐优先级排列，适用于不同部署场景：
使用反向代理前置限流（最推荐）
将 FrankenPHP 作为后端服务，前面加一层具备限流能力的反向代理（如 Nginx 或 Caddy），由它统一处理 IP 统计与拦截。
-
Nginx 示例（推荐）
在location块中配置漏桶限流，作用于所有路径或特定接口：limit_req_zone $binary_remote_addr zone=ip_limit:10m rate=30r/m; server { listen 80; location / { proxy_pass http://127.0.0.1:8080; # FrankenPHP 监听地址 limit_req zone=ip_limit burst=5 nodelay; proxy_set_header X-Real-IP $remote_addr; } }-
rate=30r/m：每分钟最多 30 次请求 -
burst=5：允许突发 5 次（缓存队列） -
nodelay：不延迟，超限直接返回 503
-
-
Caddy 示例（简洁易用）
立即学习“PHP免费学习笔记（深入）”；
:80 { reverse_proxy localhost:8080 { header_up X-Real-IP {remote_host} } @abuse ip 192.168.0.0/16 { rate_limit 30 60s } handle @abuse { respond "Too many requests" 429 } }
在 PHP 应用层做轻量限流（适合简单场景）
若无法修改反向代理（如托管环境），可在入口脚本（如 public/index.php）中快速实现基于 Redis 的 IP 计数。
$redis = new Redis();
$redis->connect('127.0.0.1', 6379);
$clientIP = $_SERVER['REMOTE_ADDR'] ?? '0.0.0.0';
// 支持 X-Forwarded-For（需确保反代已设 trusted proxies）
if (!empty($_SERVER['HTTP_X_FORWARDED_FOR'])) {
$ips = array_map('trim', explode(',', $_SERVER['HTTP_X_FORWARDED_FOR']));
$clientIP = $ips[0] ?? $clientIP;
}
$key = "rate:ip:{$clientIP}";
$count = $redis->incr($key);
if ($count == 1) {
$redis->expire($key, 60); // 60 秒窗口
}
if ($count > 50) {
http_response_code(429);
echo "Too many requests";
exit;
}⚠️ 注意：此方式依赖 Redis 性能，且不能防住高频短连接攻击（因每次请求都进 PHP）；仅建议用于低频接口或临时补救。
结合 FrankenPHP 的 X-PHP-Response-Header 或自定义中间件（进阶）
FrankenPHP 支持通过 X-PHP-Response-Header 注入响应头，但不支持运行时中断请求。因此不能在 PHP 中“拦截并丢弃请求”。真正可行的中间件方案需借助其 Worker 模式 + 自定义 Go 逻辑，或使用 Spiral Framework 等兼容 FrankenPHP 的全栈框架，它们可在请求生命周期早期介入并限流——但这已超出纯 FrankenPHP 范畴，属于应用架构选型。
不复杂但容易忽略：真实客户端 IP 必须准确传递。无论用哪种方式，都要确认 X-Forwarded-For 已被可信代理设置，并在 FrankenPHP 配置中启用 remote_ip_trusted_proxies（如 Nginx 在 proxy_set_header X-Real-IP $remote_addr; 后，FrankenPHP 需设 trusted_proxies = ["127.0.0.1"]）。否则 $ _SERVER['REMOTE_ADDR'] 可能全是 127.0.0.1，导致限流失效。
