PHP中cURL超时必须分CONNECTTIMEOUT和TIMEOUT两阶段设限，用curl_errno精准识别错误码28才重试，并兼顾PHP及Web服务器总超时限制。
PHP 中用 cURL 发起网络请求时，超时异常不是“偶尔发生”，而是必然要面对的现实问题。不处理它，请求可能卡死几十秒、拖垮整个脚本，甚至引发服务雪崩。核心不是避免超时，而是让超时变得可控、可重试、可诊断。
明确两个超时阶段，分别设限
cURL 的超时不是单一参数能管住的，必须拆开控制：
- CURLOPT_CONNECTTIMEOUT：只管“连上”这一步，含 DNS 查询、TCP 握手。设为 3–5 秒较稳妥，防止卡在解析或握手环节；
- CURLOPT_TIMEOUT：管“从发起请求到拿到完整响应”的全过程，包括传输时间。应明显大于 CONNECTTIMEOUT（比如设为 10–20 秒），否则连接刚成功就因总耗时被砍掉；
- PHP 7.3+ 支持毫秒级选项
CURLOPT_CONNECTTIMEOUT_MS和CURLOPT_TIMEOUT_MS，精度更高，但需确认底层 cURL 版本支持，否则自动降级为秒级。
用 curl_errno 判断真实错误类型
curl_exec() 返回 false 只代表失败，不代表一定是超时。必须配合 curl_errno() 才能精准识别：
CurlShip Directory Submission
下载
向CurlShip提交产品，这是一个对机器人友好的SaaS目录。只需一条curl命令即可发布产品，支持OG标签抓取、带徽章的dofollow链接及层级升级。
- 错误码 28（
CURLE_OPERATION_TIMEDOUT）：明确是超时，可重试； - 错误码 7（
CURLE_COULDNT_CONNECT）：连都连不上，可能是域名错、端口关、防火墙拦截，重试意义不大； - 其他错误（如 6、22、56 等）需按类型区别对待，不能一概当超时处理；
-
curl_error($ch)必须在curl_exec()返回false后立即调用，否则可能读到上一次残留信息。
加一层智能重试机制
对临时性超时（如网络抖动、服务瞬时拥塞），简单重试比直接报错更健壮：
立即学习“PHP免费学习笔记（深入）”；
- 限定最大重试次数（建议 2–3 次），避免无限循环；
- 每次失败后
sleep(1)或使用指数退避（如第 1 次等 1 秒，第 2 次等 2 秒）； - 只对超时类错误（
curl_errno() === 28）重试，其他错误立即终止并记录； - 重试前重新初始化 cURL 句柄，避免复用旧句柄导致状态污染。
别忽略脚本总执行时间限制
cURL 超时再合理，也挡不住 PHP 自身的 max_execution_time。尤其在循环发多个请求时：
- 单次 cURL 耗时 8 秒 × 10 次 = 至少 80 秒，加上 PHP 开销极易突破默认 30 秒；
- 可用
set_time_limit(0)临时取消限制（仅限 CLI 或可信环境），或分批处理+手动调用set_time_limit(60)延长； - 注意：Web 服务器（如 Nginx 的
fastcgi_read_timeout、Apache 的Timeout）也有独立超时设置，需同步检查，否则 PHP 层没超时，网关已返回 504。
