PHP cURL 怎样区分连接超时和响应超时

PHP cURL 里，CURLOPT_CONNECTTIMEOUT 只限制建立连接前后的等待，CURLOPT_TIMEOUT 限制一次传输从开始到结束的总时长。所谓“响应超时”通常不是一个独立选项，而是服务端已经连上后，等待首字节或接收响应体过慢。遇到 cURL error 28 时，先看时间字段，再决定是查 DNS、网络、代理还是上游服务。

官方地址：https://www.php.net/manual/en/function.curl-setopt.php

PHP cURL 的两个超时分别管什么

一次 HTTP 请求可以拆成 DNS 解析、TCP/TLS 建连、发送请求、等待服务端首字节、接收响应体几个阶段。连接超时只覆盖前面的连接准备；总超时覆盖整个传输。因此只配置连接超时并不安全：连接成功后，慢接口仍可能占住 PHP-FPM worker。

先配置连接上限，再给整次请求设预算

常见服务调用可以让连接预算小于总预算，例如连接最多等 3 秒，整次传输最多等 10 秒。不要把两个值设成一样后就认为已经区分了阶段；总超时仍会在连接阶段先到时，最终需要结合错误位置判断。

 true, // 把响应体交给变量，避免直接输出到页面
    CURLOPT_CONNECTTIMEOUT => 3,    // DNS/TCP/TLS 建立连接的最大等待秒数
    CURLOPT_TIMEOUT => 10,          // 从开始到响应体收完的总预算
    CURLOPT_FOLLOWLOCATION => false // 不让未知跳转悄悄扩大请求范围
]);

$body = curl_exec($ch);
$errno = curl_errno($ch);
$error = curl_error($ch);
$info = curl_getinfo($ch); // 在关闭句柄前读取本次传输的时间信息
curl_close($ch); // 及时释放连接资源

if ($body === false) {
    // 28 常见于连接或总传输超时，仍要结合时间字段区分阶段。
    throw new RuntimeException("cURL {$errno}: {$error}");
}

echo $info['http_code']; // HTTP 状态码只能说明服务端是否返回了响应
?>

如果只需要控制总时长，可使用 CURLOPT_TIMEOUT_MS。但毫秒级配置不代表每个底层解析器都会提供同样精细的计时，生产上仍应结合实际链路和错误日志设置安全余量。

用错误码和时间字段定位超时

curl_errno() 给出错误编号，curl_error() 给出可读信息；两者都不能单独告诉你“等待首字节”还是“接收响应体”变慢。curl_getinfo() 会保留最近一次传输的计时字段：

= $connect && $total - $firstByte 

这里的判断是排查线索，不是对网络故障的绝对证明。代理可能让客户端只看到代理的连接时间，重定向也会把多个请求合并到一次总耗时里；因此还应记录最终 URL、HTTP 状态码和是否经过代理。

代理、重定向和 PHP-FPM 的边界要单独看

1. 如果请求经过反向代理，分别记录“PHP 到代理”和“代理到上游”的超时，不能把客户端时间直接当成应用处理时间。
2. 若启用重定向，单次 CURLOPT_TIMEOUT 需要覆盖整个跳转链；不信任用户输入的 URL 时不要随意开启 CURLOPT_FOLLOWLOCATION。
3. PHP-FPM、Nginx 和上游服务也有自己的超时。cURL 返回超时前，网关可能已经先返回 504；反过来也可能是 PHP worker 先被总预算释放。
4. 不要用 CURLOPT_SSL_VERIFYPEER => false 来“修复”握手慢或证书问题；证书校验是安全边界，应该修复 CA 配置。

上线前的超时检查清单

把连接超时、总超时、错误码、namelookup_time、connect_time、starttransfer_time 和 total_time 一起写入结构化日志。重试策略也要绑定错误类型：连接失败可谨慎重试，已经发送并可能产生副作用的 POST 则要依靠幂等键，不能看到 28 就无条件重放。

常见问题

PHP cURL 有没有只限制“等待响应”的选项？

常用 cURL 选项里没有一个完全等同于“首字节超时”的 PHP 开关。通常用总超时兜底，再用 starttransfer_time - connect_time 判断连接后等待是否过长。

连接超时设为 3 秒、总超时设为 10 秒，是否一定等 13 秒？

不会。两个限制是嵌套关系，总计时从传输开始计算；连接阶段若先达到 3 秒就结束，其他阶段最多受 10 秒总预算约束。