PHP请求超时默认多久？PHP超时设置详解

PHP请求超时并非一个简单配置就能解决的问题，而是横跨cURL、file_get_contents、PHP-FPM、Nginx乃至操作系统的多层协同机制——cURL默认永不超时（CURLOPT_TIMEOUT和CONNECTTIMEOUT均为0），file_get_contents完全不读取php.ini的socket设置、必须显式构造stream_context，而Web服务器层（如Nginx的fastcgi_read_timeout）和PHP-FPM层（如request_terminate_timeout）的超时会无条件优先中断请求，导致脚本内设置形同虚设；稍有不慎就会引发worker卡死、连接堆积、QPS断崖下跌等隐蔽故障。真正可靠的超时策略需毫秒级精准控制（如CURLOPT_TIMEOUT_MS）、分阶段设定（连接+总耗时分离）、结合P95延迟预留缓冲，并强制启用CURLOPT_NOSIGNAL防崩溃，否则所谓“设了超时”可能只是自我安慰。

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请求超时默认多久？PHP超时设置详解》的介绍应该让你收获多多了吧！欢迎大家收藏或分享给更多需要学习的朋友吧~golang学习网公众号也会发布文章相关知识，快来关注吧！