当 PHP 的 cURL 请求因本地无网络而失败时，可通过检查 curl_errno() 是否等于 7（CURLE_COULDNT_CONNECT）来准确识别“无互联网”状态，而非泛化处理所有错误。
当 php 的 curl 请求因本地无网络而失败时，可通过检查 `curl_errno()` 是否等于 7（`curle_couldnt_connect`）来准确识别“无互联网”状态，而非泛化处理所有错误。
在使用 cURL 发起 HTTP 请求时，网络不可用（如断网、DNS 不可达、目标服务器完全无法建立 TCP 连接）通常表现为底层连接失败，而非 HTTP 层错误。此时 cURL 会返回特定的错误码——根据 cURL 官方错误列表，错误码 7（CURLE_COULDNT_CONNECT）明确表示“无法连接到主机或代理”，这是判断“本机无有效互联网连接”最可靠、最语义清晰的依据。
⚠️ 注意：不能仅依赖 curl_exec() 返回 false 或 curl_error() 非空就断定“没网”。例如：
-
CURLE_OPERATION_TIMEDOUT (28)可能是网络延迟高，而非断网； -
CURLE_SSL_CONNECT_ERROR (35)多为证书或 TLS 协议问题； -
CURLE_COULDNT_RESOLVE_HOST (6)表示 DNS 解析失败（可能 DNS 配置异常，但网络本身通畅）。
因此，推荐在错误处理逻辑中精准匹配错误码 7，并辅以合理超时控制（避免长时间阻塞）：
CurlShip Directory Submission
下载
向CurlShip提交产品，这是一个对机器人友好的SaaS目录。只需一条curl命令即可发布产品，支持OG标签抓取、带徽章的dofollow链接及层级升级。
$ch = curl_init();
curl_setopt_array($ch, [
CURLOPT_URL => $api_url,
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HEADER => false,
CURLOPT_FOLLOWLOCATION => true,
CURLOPT_TIMEOUT => 10, // 强烈建议设置超时（秒）
CURLOPT_CONNECTTIMEOUT => 5, // 连接阶段超时（秒）
CURLOPT_SSL_VERIFYPEER => false,
CURLOPT_FAILONERROR => false, // 建议设为 false，由业务自行判断 HTTP 状态码
]);
$response = curl_exec($ch);
$errno = curl_errno($ch);
if ($errno !== 0) {
if ($errno === CURLE_COULDNT_CONNECT) {
throw new RuntimeException('Network unavailable: failed to establish network connection.');
} else {
throw new RuntimeException("cURL error ({$errno}): " . curl_error($ch));
}
}
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
// 后续可继续检查 $httpCode 判断 API 业务逻辑是否成功
if ($httpCode >= 400) {
throw new RuntimeException("API request failed with HTTP {$httpCode}");
}
return $response;✅ 最佳实践总结：
立即学习“PHP免费学习笔记（深入）”；
- 始终设置
CURLOPT_TIMEOUT和CURLOPT_CONNECTTIMEOUT，防止无限等待； - 仅将
CURLE_COULDNT_CONNECT (7)视为“无互联网”的权威信号； - 不要关闭
CURLOPT_FAILONERROR后忽略 HTTP 状态码——连接成功 ≠ 业务成功； - 生产环境建议结合
ping或 DNS 查询（如dns_get_record()）做前置连通性探测，实现更早失败（fail-fast）。
