cURL 默认超时为0(永不超时),需显式设置 CURLOPT_TIMEOUT 和 CURLOPT_CONNECTTIMEOUT;file_get_contents() 超时须通过 stream_context_create() 配置,与 php.ini 设置无关;PHP-FPM 和 Nginx 层超时会优先触发终止。

PHP cURL 默认超时是 0(永不超时)
很多人以为 curl_setopt() 没设超时就按系统或 PHP 配置走,其实不是:只要没显式调用 curl_setopt($ch, CURLOPT_TIMEOUT, ...) 或 CURLOPT_CONNECTTIMEOUT,cURL 句柄发起请求后会一直等下去,直到网络断开、服务端主动关闭,或进程被 kill —— 这在生产环境极易导致 PHP-FPM worker 卡死、连接堆积。
常见错误现象:curl_exec() 卡住几十秒甚至几分钟,top 看到大量 php-fpm: pool www 处于 R(running)状态,日志里却无报错。
-
CURLOPT_TIMEOUT控制整个请求周期(DNS + 连接 + 发送 + 接收)上限,单位秒,**默认值为 0** -
CURLOPT_CONNECTTIMEOUT仅控制 TCP 连接建立阶段,**默认值也是 0** - 若只设
CURLOPT_CONNECTTIMEOUT而不设CURLOPT_TIMEOUT,连接成功后仍可能无限等待响应体
file_get_contents() 的超时由 stream_context 决定
file_get_contents() 底层走的是 PHP stream,它的超时和 cURL 完全无关,也不读取 default_socket_timeout ini 设置(该设置只影响 fsockopen() 等原生 socket 函数)。
必须显式传入 stream_context_create() 并配置 timeout 选项,否则行为未定义(实际表现常为约 60 秒,但这是底层 libc 或 OS 的默认行为,不可依赖)。
立即学习“PHP免费学习笔记(深入)”;
- 正确写法:
$ctx = stream_context_create(['http' => ['timeout' => 5]]); file_get_contents('https://api.example.com', false, $ctx); -
timeout单位是秒,支持浮点数(如0.5),但低于 1 秒时需确认目标服务器和中间代理是否真能快速响应 - 注意:这个
timeout是总耗时上限,无法单独控制连接与读取阶段
PHP-FPM 和 Nginx 层的超时会覆盖脚本内设置
即使你在 PHP 里把 cURL 超时设成 3 秒,如果 Nginx 的 fastcgi_read_timeout 是 60 秒,而 PHP-FPM 的 request_terminate_timeout 是 30 秒,那么实际中断点取决于最先触发的那个。
- Nginx 侧典型配置:
fastcgi_connect_timeout 5; fastcgi_send_timeout 10; fastcgi_read_timeout 15; - PHP-FPM 侧关键项:
request_terminate_timeout(强制杀进程)、request_slowlog_timeout(记录慢日志) - 三者关系不是叠加,而是“任一超时即终止”,且 PHP 层超时无法阻止 FPM 主动 kill
超时设置不当引发的隐蔽问题
设太短:HTTP 302 重定向、TLS 握手慢、CDN 回源延迟都可能误判为超时;设太长:单个慢请求拖垮整组 worker,QPS 断崖下跌。
- 推荐组合:
CURLOPT_CONNECTTIMEOUT_MS(毫秒级,如 2000) +CURLOPT_TIMEOUT_MS(如 8000),避免整秒截断误差 - 对第三方 API,建议按 P95 延迟 × 2 设定,并预留重试逻辑(如 1 次 retry,间隔 100ms)
-
curl_setopt($ch, CURLOPT_NOSIGNAL, true)必须开启,否则在某些 Linux 环境下 SIGALRM 会导致 cURL 直接崩溃而非抛异常











