file_get_contents() 默认无超时会卡数分钟,须用stream_context_create()设http timeout(浮点秒);fopen()配stream_set_timeout()仅影响读操作,不控连接;curl用curlopt_connecttimeout和curlopt_timeout分控连接与总时长;php-fpm可能强杀请求,需确保脚本超时小于其request_terminate_timeout。

file_get_contents() 远程请求卡住 10 秒以上
默认不设超时,file_get_contents() 会等到底,直到服务器断连或 TCP 层超时(常达数分钟),实际表现就是“卡住不动”。这不是 PHP 崩了,是它真在等。
- 必须显式传
stream_context_create(),靠http选项里的timeout控制——注意:这是浮点秒,不是整数,3.5合法,3也合法 -
timeout只管连接建立后传输阶段,不包含 DNS 解析和 TCP 握手;如果 DNS 慢或目标 IP 不通,仍可能卡更久 - 别用
default_socket_timeoutini 设置全局改,它对file_get_contents()无效(只影响fsockopen()等底层函数)
file_get_contents('https://api.example.com/data.json', false, stream_context_create([
'http' => ['timeout' => 5.0]
]));
fopen() + stream_set_timeout() 为什么还是不生效
用 fopen() 打开远程 URL 时,stream_set_timeout() 对已建立的流有效,但前提是:你得先成功打开。而打开失败(如 DNS 失败、连接拒绝)本身不受该函数控制。
- 真正起作用的是
stream_context_set_option($ctx, 'http', 'timeout', 4),和file_get_contents()用同一套上下文机制 -
stream_set_timeout()只影响后续fread()/fgets()等读操作的阻塞等待,不是“整个请求超时” - 若需精细控制(比如 DNS 超时、连接超时分离),得换
cURL,PHP 自带流封装器做不到
cURL 的 CURLOPT_TIMEOUT 和 CURLOPT_CONNECTTIMEOUT 区别
这是最常混用的一对参数。一个管“从发起到收完全部响应”的总时间,一个只管“TCP 连接建好为止”。
-
CURLOPT_CONNECTTIMEOUT:仅 DNS 查询 + TCP 三次握手 + TLS 握手,单位是整数秒,设太小容易误杀高延迟但可用的接口 -
CURLOPT_TIMEOUT:从curl_exec()开始计时,到响应体收完为止,包含上传、等待、下载全过程;设太小可能截断大文件 - 建议组合使用:
CURLOPT_CONNECTTIMEOUT = 3,CURLOPT_TIMEOUT = 8,留出 5 秒给实际数据传输
$ch = curl_init('https://api.example.com/large.json');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CONNECTTIMEOUT, 3);
curl_setopt($ch, CURLOPT_TIMEOUT, 8);
超时设置在 PHP-FPM 下被 silently 忽略?
不是被忽略,是被覆盖。PHP-FPM 的 request_terminate_timeout 或 Nginx 的 fastcgi_read_timeout 会强行 kill 掉整个请求进程,此时你的脚本里设的任何 socket 超时都来不及响应。
立即学习“PHP免费学习笔记(深入)”;
- 查日志看是否出现
WARNING: [pool www] child 12345 exited on signal 9 (SIGKILL)—— 这就是 FPM 强杀的证据 - 线上环境务必让
CURLOPT_TIMEOUT或http.timeout小于 FPM 的request_terminate_timeout,至少留 2 秒缓冲 - 异步任务、长轮询、大文件拉取这类场景,别走 Web 请求入口,改用 CLI 模式跑,绕过所有 Web 服务器超时限制











