FrankenPHP 1.4 的 Worker 模式本身不内置限流逻辑，需通过 Nginx 前置限流、PHP 层 Redis 令牌桶或系统资源约束（如 ulimit、MemoryMax）协同实现生产级限流。
FrankenPHP 1.4 的 Worker 模式本身不内置限流逻辑，它复用 PHP 的异步事件循环（基于 Swoole 或原生 ext/event），核心职责是高效处理 HTTP 请求生命周期，而非主动拦截或节流。真正的限流必须通过外部配置层或应用层代码实现，不能依赖 FrankenPHP 自动降载。
以下是针对 Worker 模式下切实可行、生产环境验证过的限流配置路径：
Nginx 前置限流（推荐首选）
FrankenPHP 通常以 FastCGI 或 HTTP 反向代理方式部署在 Nginx 后方。这是最成熟、低侵入、高可靠的方式：
-
在
nginx.conf的http块中定义限流区：立即学习“PHP免费学习笔记（深入）”；
limit_req_zone $binary_remote_addr zone=franken_api:10m rate=5r/s; limit_conn_zone $binary_remote_addr zone=franken_conn:10m;
-
在转发到 FrankenPHP 的
location块中启用：location /api/ { limit_req zone=franken_api burst=15 nodelay; limit_conn franken_conn 20; proxy_pass http://127.0.0.1:8080; # FrankenPHP HTTP server 地址 proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; }✅ 效果：按 IP 控制每秒 5 个请求（允许突发 15 个），同时限制同一 IP 最多 20 个并发 TCP 连接（防长连接耗尽）。
FrankenPHP 内部配合 PHP 层限流（需编码）
若你使用 FrankenPHP 的 php-http-server 模式（直接监听 HTTP 端口，绕过 Nginx），则需在 PHP 应用中嵌入限流逻辑：
-
使用 Redis + 令牌桶（推荐）：
use Predis\Client; $redis = new Client('tcp://127.0.0.1:6379'); $ip = $_SERVER['REMOTE_ADDR']; $key = "rate:{$ip}"; // 每分钟最多 60 次，令牌桶容量 60，每秒补充 1 个 $now = time(); $bucket = $redis->hGetAll($key); $tokens = $bucket['tokens'] ?? 60; $lastTime = $bucket['last_time'] ?? $now; $elapsed = $now - $lastTime; $newTokens = min(60, (int)($tokens + $elapsed)); // 补充令牌 $tokens = max(0, $newTokens - 1); // 消费 1 个 if ($tokens < 0) { http_response_code(429); exit('Too many requests'); } $redis->hMset($key, ['tokens' => $tokens, 'last_time' => $now]); $redis->expire($key, 60); 部署时确保
predis/predis已安装，Redis 服务可用，且 FrankenPHP 进程有稳定连接。
系统与资源级兜底（防止雪崩）
Worker 模式长期运行，必须约束底层资源，否则限流形同虚设：
-
设置 FrankenPHP 进程最大文件描述符数（启动前）：
ulimit -n 65536 ./frankenphp worker --env=prod --max-requests=10000
-
在
frankenphp.yaml（如有）或 systemd service 文件中固定限制：[Service] LimitNOFILE=65536 MemoryMax=1G
同时调低 PHP 的
max_execution_time和memory_limit，避免单请求拖垮整个 Worker。
FrankenPHP 的 Worker 模式追求轻量与性能，限流不是它的责任边界。把 Nginx 当“守门人”，把 Redis 当“计数器”，把 ulimit 当“安全阀”，三者协同才能稳住流量入口。
