frankenphp 请求超时需在caddyfile顶部frankenphp块中配置http_client_timeout（如25s），而非php参数；php层curl等需手动设超时；上游代理超时也须≥此值。
FrankenPHP 中设置请求超时时间，核心在 Caddy 的 HTTP 客户端配置层，不是改 PHP 的 max_execution_time 或 cURL 参数——它走的是内置的、更底层的 HTTP 客户端机制。
在 Caddyfile 中配置全局 HTTP 客户端超时
FrankenPHP 依赖 Caddy 作为反向代理和运行时网关，其内置 HTTP 客户端行为由 frankenphp 全局块控制。必须在 Caddyfile 顶部（非站点块内）添加如下配置：
-
设置默认超时：
http_client_timeout 30s—— 这是整个外部 HTTP 请求（DNS + 连接 + 发送 + 接收）的硬性上限，推荐设为 15～45 秒，视第三方服务稳定性而定 -
限制并发连接数：
http_client_max_conns 100—— 防止突发大量出站请求耗尽系统 socket 资源，高并发场景建议设为 200～500 -
启用连接复用与缓存：
http_client_idle_conns 50和http_client_idle_timeout 60s可减少重复建连开销，间接降低超时风险
完整示例：
{<br> frankenphp {<br> http_client_max_conns 200<br> http_client_idle_conns 80<br> http_client_idle_timeout 90s<br> http_client_timeout 25s<br> }<br>}<br><br>localhost:8080 {<br> php_server<br>}
PHP 层仍需配合做兜底控制
FrankenPHP 的 HTTP 客户端只管“发起请求”，但如果你在 PHP 代码里自己用了 curl_exec()、file_get_contents() 或 Guzzle，默认不受 Caddy 配置影响，必须手动设超时：
- cURL 请求：务必显式设置
CURLOPT_CONNECTTIMEOUT_MS（建议 3000～5000）和CURLOPT_TIMEOUT_MS（建议 10000～25000），并启用CURLOPT_NOSIGNAL = 1 - file_get_contents：用
stream_context_create(['http' => ['timeout' => 10]])单独指定，单位是秒 - 数据库/Redis 等：仍需按常规方式设连接与读写超时（如 PDO DSN 加
connect_timeout=3），FrankenPHP 不接管这些
别漏掉 Web 服务器级协同
即使 Caddy 和 PHP 都设了 25 秒，若上游有 Nginx 或负载均衡器，它的 proxy_read_timeout 或 fastcgi_read_timeout 若设为 10 秒，请求会在 10 秒被强制切断——FrankenPHP 无法挽回。检查所有中间链路的超时设置，确保它们 ≥ Caddy 的 http_client_timeout。
验证与调试方法
启动 Caddy 后执行：caddy adapt --config Caddyfile --pretty，确认输出中包含 frankenphp 块及对应 timeout 字段；再用 curl -v https://your-api.com/test 观察响应头中的 X-Response-Time 或直接制造慢接口测试是否在设定时间内断开。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
