PHP请求超时默认时间设置解析

PHP请求超时并非简单的配置项，而是一个横跨cURL、stream、PHP-FPM和Nginx四层的复杂控制链：cURL默认永不超时（CURLOPT_TIMEOUT和CONNECTTIMEOUT均为0），file_get_contents完全不读取php.ini的socket设置、必须显式构造stream_context，而PHP层再精细的超时设置也会被Nginx的fastcgi_read_timeout或PHP-FPM的request_terminate_timeout优先截断——任一环节疏忽都可能导致worker卡死、连接堆积、QPS雪崩。真正可靠的超时策略需毫秒级精准控制（如CONNECTTIMEOUT_MS+TIMEOUT_MS）、禁用SIGALRM信号、结合P95延迟动态设定并内置重试，否则看似安全的代码实则埋着生产环境最隐蔽的性能地雷。

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 的默认行为，不可依赖）。

• 正确写法：

  $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 直接崩溃而非抛异常

理论要掌握，实操不能落！以上关于《PHP请求超时默认时间设置解析》的详细介绍，大家都掌握了吧！如果想要继续提升自己的能力，那么就来关注golang学习网公众号吧！