laravel 11 中 curl 超时需显式设置 curlopt_connecttimeout（3–5秒）和 curlopt_timeout（10–30秒），guzzle 则用 connecttimeout() 和 timeout() 方法；忽略前者可能导致连接挂起，超时失效。
Laravel 11 本身不直接封装 cURL 超时设置，它底层仍依赖 PHP 的 curl_setopt() 函数（比如通过 Guzzle HTTP Client 或自定义 cURL 请求）。所以“Laravel 11 的 cURL 超时设置”，本质是 在 Laravel 11 环境中安全、合理地配置 PHP cURL 的超时参数。关键不是框架改了什么，而是你用 cURL 时怎么设才不卡死、不误判。
Laravel 11 中手动使用 cURL 时的超时设置
如果你在控制器、Job 或 Service 中直接调用 curl_init()，必须显式设置以下两个核心超时项：
-
CURLOPT_CONNECTTIMEOUT：仅控制建立 TCP 连接的时间（DNS + TCP 握手），建议设为 3–5 秒 -
CURLOPT_TIMEOUT：控制整个请求生命周期（含连接、发送、接收响应），建议设为 10–30 秒，且必须 ≥CONNECTTIMEOUT
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 'https://api.example.com/data');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CONNECTTIMEOUT, 5); // 连接阶段最多等 5 秒
curl_setopt($ch, CURLOPT_TIMEOUT, 15); // 整个请求最多 15 秒
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, true);
$response = curl_exec($ch);
if ($response === false) {
$error = curl_error($ch);
\Log::warning('cURL failed', ['error' => $error, 'url' => 'https://api.example.com/data']);
}
curl_close($ch);
⚠️ 注意：不要只设
CURLOPT_TIMEOUT而忽略CONNECTTIMEOUT。某些网络故障（如 DNS 污染、防火墙拦截）会让连接无限挂起，TIMEOUT可能无法及时生效——因为CONNECTTIMEOUT是更前置的熔断开关。
accurLex专业合同审查下载基于5000余部现行法律法规进行的高质量专业合同审查，一键输出审查意见书，并附有参考法条原文，满足专业溯源核查要求。由accurLex知法提供技术支持。 Use when users ask for 合同审查, 审查意见书, 合同风险分析, 条款审查,知法,accurLex or 站在甲方/乙方角度审查合同 through accurLex direct API. China law only, plaintext only, review mode limited to 审查意见书.
使用 Guzzle（Laravel 11 默认推荐 HTTP 客户端）时的超时设置
Laravel 11 项目通常用 Guzzle（通过 Http facade 或 GuzzleHttp\Client），它把 cURL 封装得更安全，超时配置也更直观：
use Illuminate\Support\Facades\Http;
$response = Http::timeout(10) // 总超时：10 秒（等同 CURLOPT_TIMEOUT）
->connectTimeout(3) // 连接超时：3 秒（等同 CURLOPT_CONNECTTIMEOUT）
->get('https://api.example.com/data');
if ($response->failed()) {
\Log::warning('HTTP request failed', ['status' => $response->status()]);
}
-
timeout()对应CURLOPT_TIMEOUT -
connectTimeout()对应CURLOPT_CONNECTTIMEOUT - 若未指定
connectTimeout，Guzzle 默认使用timeout值作为连接和总超时的共同上限（不够精细，建议显式分开）
避免常见陷阱
- 不要在队列任务里用
set_time_limit(0)或盲目调大max_execution_time—— 这会掩盖真实问题，且与 cURL 超时无关 - 不要依赖
CURLOPT_TIMEOUT_MS或CURLOPT_CONNECTTIMEOUT_MS（毫秒级），除非你明确需要亚秒精度；Laravel 11 + PHP 8.2+ 环境下它们需配合CURLOPT_NOSIGNAL=true才可靠，否则可能被系统信号中断干扰 - 如果请求目标是外部 API，建议额外加
retry(2)（Guzzle）或逻辑重试，但重试前确保超时值已留出缓冲（例如 timeout=10s，重试间隔至少 1s）
不复杂但容易忽略
