必须分别设置CURLOPT_CONNECTTIMEOUT_MS（如3000）和CURLOPT_TIMEOUT_MS（如10000）以实现双超时，仅用秒级选项或file_get_contents无法精确控制连接阶段超时，且需通过curl_errno区分CURLE_COULDNT_CONNECT与CURLE_OPERATION_TIMEDOUT。
curl_setopt 设置连接超时和执行超时
PHP 用 curl 发请求时，必须分开设置连接阶段和整个请求生命周期的超时，否则可能卡死或误判失败。连接超时（CURLOPT_CONNECTTIMEOUT_MS）控制 DNS 解析 + TCP 握手耗时，执行超时（CURLOPT_TIMEOUT_MS）控制从连接成功到响应结束的总时间。
常见错误是只设 CURLOPT_TIMEOUT（秒级），导致小数秒级精度不够，或在高延迟网络下连接迟迟不返回却没被及时中断。
-
CURLOPT_CONNECTTIMEOUT_MS推荐设为 3000（3 秒），低于 1000 容易误杀正常弱网连接 -
CURLOPT_TIMEOUT_MS应大于CONNECTTIMEOUT_MS，比如设为 10000（10 秒） - 两个都必须用
_MS版本，否则CURLOPT_TIMEOUT和CURLOPT_CONNECTTIMEOUT只支持整秒，且低版本 PHP 会向下取整 - 启用
CURLOPT_RETURNTRANSFER，避免超时后输出直接刷到页面
$ch = curl_init('https://api.example.com/data');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CONNECTTIMEOUT_MS, 3000);
curl_setopt($ch, CURLOPT_TIMEOUT_MS, 10000);
$response = curl_exec($ch);
if ($response === false) {
$errno = curl_errno($ch);
if ($errno === CURLE_OPERATION_TIMEDOUT || $errno === CURLE_COULDNT_CONNECT) {
// 区分是连不上，还是连上后处理太久
}
}
curl_close($ch);
file_get_contents 怎么加双超时
file_get_contents 本身不支持独立连接超时，只能靠 stream_context_create 配置整体超时（timeout），它等效于 CURLOPT_TIMEOUT，无法控制连接阶段。
所以如果你坚持用 file_get_contents，实际只有“执行超时”，没有真正意义上的“连接超时”。某些场景下（如 DNS 污染、防火墙拦截 SYN 包），请求会卡在 connect 阶段远超设定值。
立即学习“PHP免费学习笔记（深入）”；
-
timeout参数单位是秒，支持浮点数（如3.5），但底层仍是 select/poll 等待，不能精确中断 TCP 连接尝试 - 无法通过上下文区分
Connection refused和Connection timed out - 若需双超时，硬要走
file_get_contents，只能自己 fork 进程或用 pcntl_alarm（不推荐，复杂且不可靠）
$opts = [
'http' => [
'method' => 'GET',
'timeout' => 5.0, // 注意：这是总超时，不是连接超时
'ignore_errors' => true,
]
];
$ctx = stream_context_create($opts);
$result = file_get_contents('https://api.example.com/data', false, $ctx);
超时判断后怎么知道是哪一阶段失败
仅靠返回 false 或异常无法定位问题，必须结合 curl_errno 或错误信息字符串分析。
关键错误码有：CURLE_COULDNT_CONNECT（连接阶段失败）、CURLE_OPERATION_TIMEDOUT（执行超时）、CURLE_SSL_CONNECT_ERROR（SSL 握手超时，也算连接阶段）。
- 不要依赖
curl_error($ch)的中文描述，它受 locale 影响；优先用curl_errno($ch)判断 -
CURLE_OPERATION_TIMEDOUT表示已建立连接但响应太慢；CURLE_COULDNT_CONNECT表示连 IP 都没连上 - 如果用了
CURLOPT_CONNECTTIMEOUT_MS却仍出现CURLE_OPERATION_TIMEDOUT，说明连接成功了，只是后续读写慢——这时该优化接口或加重试，而不是调连接超时
容易被忽略的底层细节
Linux 下，TCP 连接超时实际受内核参数影响：net.ipv4.tcp_syn_retries 默认为 6，意味着 SYN 重传最多 6 次，理论最长等待约 127 秒。即使你设了 CURLOPT_CONNECTTIMEOUT_MS 为 1000，cURL 仍可能被内核拖住更久——尤其在目标端口完全无响应（非拒绝，而是静默丢包）时。
- cURL 7.32.0+ 才真正支持毫秒级
CONNECTTIMEOUT_MS，旧版本会退化为秒级 - 启用了
CURLOPT_TCP_FASTOPEN可能略微缩短连接时间，但不改变超时逻辑 - DNS 解析超时独立于
CONNECTTIMEOUT_MS，默认由系统决定；如需控制，得配合CURLOPT_RESOLVE或自建 DNS 缓存
