PHP 8.4 的 cURL 超时需分三类设置：CURLOPT_CONNECTTIMEOUT_MS 控制 DNS+TCP+TLS 阶段；CURLOPT_TIMEOUT_MS 控制整体耗时；CURLOPT_LOW_SPEED_LIMIT/TIME 防假死。须设 CURLOPT_RETURNTRANSFER=true，超时值必须为整数毫秒，HTTPS 卡顿优先调低 CONNECTTIMEOUT_MS 并指定 TLS 版本。
PHP 8.4 中 curl 请求超时不是靠“加个参数就完事”，而是得区分清楚：你卡在 DNS 解析？TCP 连接？TLS 握手？还是服务器响应慢？不同阶段对应不同超时参数，设错一个，curl_exec() 该卡还是卡。
curl_setopt() 超时参数必须分三类设置
PHP 的 curl 超时不是单个开关，而是由三个独立选项控制，各自作用阶段不同：
-
CURLOPT_CONNECTTIMEOUT_MS：仅控制 DNS 查询 + TCP 连接 + TLS 握手的总耗时（毫秒），超时后直接失败，不发 HTTP 请求 -
CURLOPT_TIMEOUT_MS：从发起连接开始算起，到curl_exec()返回的**总耗时上限**（毫秒），包含连接、发送请求、等待响应、接收全部 body -
CURLOPT_LOW_SPEED_LIMIT和CURLOPT_LOW_SPEED_TIME：用于检测“假死”——比如服务器只发了 header 就不动了，可设为 1 字节/秒持续 30 秒即断开
常见错误是只设 CURLOPT_TIMEOUT_MS，结果 DNS 被墙或目标 IP 不通时，仍会卡满 300 秒（Linux 默认 connect timeout）。
PHP 8.4 下 CURLOPT_TIMEOUT_MS 不生效？检查是否启用了 CURLOPT_RETURNTRANSFER
PHP 8.4 对 cURL 错误处理更严格，若未显式设置 CURLOPT_RETURNTRANSFER 为 true，curl_exec() 在超时时可能返回 false 但不触发 curl_error()，容易误判为“没超时只是返回空”。务必确认：
立即学习“PHP免费学习笔记（深入）”；
基于5000余部现行法律法规进行的高质量专业合同审查，一键输出审查意见书，并附有参考法条原文，满足专业溯源核查要求。由accurLex知法提供技术支持。 Use when users ask for 合同审查, 审查意见书, 合同风险分析, 条款审查,知法,accurLex or 站在甲方/乙方角度审查合同 through accurLex direct API. China law only, plaintext only, review mode limited to 审查意见书.
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); curl_setopt($ch, CURLOPT_TIMEOUT_MS, 5000); curl_setopt($ch, CURLOPT_CONNECTTIMEOUT_MS, 3000);
另外注意：CURLOPT_TIMEOUT_MS 和 CURLOPT_CONNECTTIMEOUT_MS **必须是整数毫秒值**，传浮点数（如 5.0）或字符串（如 "5000"）在 PHP 8.4 中会被静默转为 0，导致无限等待。
HTTPS 请求卡在 TLS 握手？优先调低 CURLOPT_CONNECTTIMEOUT_MS
很多“超时”实际卡在 TLS 握手（尤其是服务端用老旧 OpenSSL 或启用了客户端证书验证），此时 CURLOPT_TIMEOUT_MS 还没开始计时。解决方法：
- 把
CURLOPT_CONNECTTIMEOUT_MS单独设为 2000–3000 毫秒，比CURLOPT_TIMEOUT_MS更短 - 禁用不必要的 TLS 版本协商：
curl_setopt($ch, CURLOPT_SSLVERSION, CURL_SSLVERSION_TLSv1_2); - 避免证书验证（仅测试环境）：
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false); curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, false);
真实线上环境不要关证书验证，应改用 CURLOPT_CAINFO 指向最新 CA bundle 路径。
最易被忽略的是：PHP 8.4 默认启用 curl 的异步 DNS 解析（CURLPIPE_HTTP1 相关行为变化），若系统 /etc/resolv.conf 配置了超时 DNS 服务器，CURLOPT_CONNECTTIMEOUT_MS 可能无法覆盖底层 glibc 的 DNS 超时。这时候得配合 CURLOPT_DNS_CACHE_TIMEOUT 或换用 CURLOPT_RESOLVE 硬编码 IP。
