如何在 PHP 中通过 cURL 检测网络连接不可用-php教程-PHP中文网

如何在 PHP 中通过 cURL 检测网络连接不可用

当 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;

✅ 最佳实践总结：