FrankenPHP1.4worker模式限流怎么配置-php教程-PHP中文网

frankenphp 1.4 的 worker 模式本身不内置限流逻辑，需通过 nginx 前置限流、php 层 redis 令牌桶或系统资源约束（如 ulimit、memorymax）协同实现生产级限流。

frankenphp1.4worker模式限流怎么配置

FrankenPHP 1.4 的 Worker 模式本身不内置限流逻辑，它复用 PHP 的异步事件循环（基于 Swoole 或原生 ext/event），核心职责是高效处理 HTTP 请求生命周期，而非主动拦截或节流。真正的限流必须通过外部配置层或应用层代码实现，不能依赖 FrankenPHP 自动降载。

以下是针对 Worker 模式下切实可行、生产环境验证过的限流配置路径：

Nginx 前置限流（推荐首选）

FrankenPHP 通常以 FastCGI 或 HTTP 反向代理方式部署在 Nginx 后方。这是最成熟、低侵入、高可靠的方式：

在 nginx.conf 的 http 块中定义限流区：

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 应用中嵌入限流逻辑：

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

使用 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 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 当“安全阀”，三者协同才能稳住流量入口。