FrankenPHP 1.4 的请求超时需通过Caddy配置层统一控制，核心是Caddyfile中php块的timeout指令（如timeout 30s），并协同php.ini的max_execution_time及cURL等外部调用的独立超时设置，形成三层超时防护机制。

FrankenPHP 1.4 本身不直接提供类似 `EventHttp::setTimeout` 那样的原生 HTTP 请求超时 API，它的请求生命周期由底层 Web 服务器（如 Caddy）控制。因此，**配置请求超时时间的关键在于 Caddy 的配置层，而非 FrankenPHP 代码内部**。 以下是你在使用 FrankenPHP 1.4 时实际可行的超时配置方式：

Caddy 全局请求超时（最常用）

Caddy 的 `timeout` 指令可限制单个 HTTP 请求从接收首字节到响应完成的总耗时。在 `Caddyfile` 中添加或修改 `reverse_proxy` 或 `php` 处理块：

示例（使用 php 指令）：

localhost {
    route {
        php {
            root /var/www
            timeout 30s  // ← 关键：整个 PHP 请求处理上限为 30 秒
        }
    }
}

该 timeout 会作用于 FrankenPHP 启动的 PHP Worker 处理全过程（包括脚本执行、I/O 等）。若超过此值，Caddy 主动断开连接并返回 504 Gateway Timeout。

PHP 脚本级执行超时（配合生效）

FrankenPHP 运行的是标准 PHP 环境，所以传统 PHP 超时设置依然有效，且需与 Caddy timeout 协调：

• 确保 php.ini 中的 max_execution_time 小于 Caddy 的 timeout 值（例如设为 25），避免 PHP 自行中止前 Caddy 已超时
• 在关键长任务脚本开头加：ini_set('max_execution_time', 25); 或 set_time_limit(25);
• 注意：FrankenPHP 不支持 set_time_limit(0) 彻底禁用超时，因 Caddy 层仍会强制切断

Worker 级空闲与连接超时（进阶）

FrankenPHP 的 Worker 进程由 Caddy 管理，其空闲行为受 Caddy 的 `health_timeout` 和 `keepalive_idle` 控制：

在 Caddyfile 的 `php` 块内可显式指定：

btpanel phpsite 宝塔面板PHP网站

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

下载

php {
    root /var/www
    timeout 30s
    health_timeout 10s     // Worker 无响应超时后重启
    keepalive_idle 60s     // 保持空闲连接最长 60 秒（适用于长轮询等场景）
}

这些参数影响 Worker 生命周期，间接决定“一次请求能等待多长时间才被判定失败”。

立即学习“PHP免费学习笔记（深入）”；

外部依赖超时不能忽略

如果你的 PHP 代码发起 cURL、PDO 连接或 socket 请求，这些操作的超时必须单独设置：

• cURL：用 CURLOPT_TIMEOUT 和 CURLOPT_CONNECTTIMEOUT
• PDO（MySQL）：DSN 中加 &connect_timeout=5，或 PDO options 设 PDO::ATTR_TIMEOUT
• file_get_contents：配合 stream_context_create() 设置 timeout 选项

FrankenPHP 1.4 的请求超时不是单一开关，而是 Caddy 配置 + PHP 运行时 + 外部调用三层协同的结果。优先从 Caddy 的 timeout 入手，再逐层收紧下级超时，才能避免“看似没超时却卡死”的情况。