PHP cURL 复用连接需同时满足:显式设置 Connection: keep-alive、CURLOPT_FORBID_REUSE=false、CURLOPT_FRESH_CONNECT=false,并优先复用同一cURL句柄以共享DNS/SSL/keep-alive状态。

PHP cURL 复用连接必须手动开启 CURLOPT_HTTPHEADER 之外的两个关键选项
默认情况下,cURL 每次 curl_exec() 都会新建 TCP 连接,即使目标 URL、Host、端口完全一致。要真正复用连接(HTTP/1.1 keep-alive 或 HTTP/2 multiplexing),必须显式设置:CURLOPT_HTTPHEADER 中包含 Connection: keep-alive(虽多数服务端默认支持,但显式声明更稳妥),更重要的是启用连接池管理:
-
CURLOPT_RETURNTRANSFER => true(非必需,但避免输出干扰) -
CURLOPT_TCP_KEEPALIVE => 1(Linux/macOS 有效,维持底层 TCP 连接存活) -
CURLOPT_FORBID_REUSE => false(必须设为false,默认是false,但有人误设为true导致强制断连) -
CURLOPT_FRESH_CONNECT => false(同上,误设为true会禁用复用)
注意:CURLOPT_TCP_KEEPALIVE 在 Windows 上无效;若需跨平台稳定复用,应优先依赖 cURL 句柄复用(见下一条)。
复用 cURL 句柄比复用连接更可靠:多次 curl_setopt() + 单句柄调用
最简单、兼容性最好的“连接复用”方式,其实是复用同一个 cURL 句柄($ch)。它天然共享 DNS 缓存、SSL session、keep-alive 状态——只要不调用 curl_close(),后续请求就会尝试复用已建立的连接。
典型错误写法:curl_init() → curl_setopt() → curl_exec() → curl_close() 每次都新建句柄,等于放弃所有复用可能。
立即学习“PHP免费学习笔记(深入)”;
正确做法:
$ch = curl_init(); curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); curl_setopt($ch, CURLOPT_POST, true); curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query(['a'=>1])); // 第一次请求 curl_setopt($ch, CURLOPT_URL, 'https://api.example.com/v1/login'); $result1 = curl_exec($ch); // 第二次请求(同一 $ch,自动尝试复用连接) curl_setopt($ch, CURLOPT_URL, 'https://api.example.com/v1/data'); curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query(['id'=>123])); $result2 = curl_exec($ch); curl_close($ch); // 仅在全部请求结束后关闭
这种模式下,只要服务端返回 Connection: keep-alive 且未超时,第二次请求大概率走复用连接,RTT 显著降低。
并发 POST 请求时连接复用失效?检查 CURLOPT_MAXCONNECTS 和句柄隔离
用 curl_multi_*() 并发多个 POST 请求时,连接复用行为变复杂:默认每个子句柄独立建连,即使目标相同。这时需主动控制连接池大小:
-
curl_multi_setopt($mh, CURLMOPT_MAXCONNECTS, 20)—— 限制整个 multi 句柄最多保持 20 个空闲连接 - 所有子句柄必须使用相同
CURLOPT_URL的 host:port(不能混用https://a.com和https://b.com) - 避免在子句柄中设置
CURLOPT_FORBID_REUSE或CURLOPT_FRESH_CONNECT
另外,并发场景下如果每个请求都新建 curl_init() 再塞进 multi,就失去了复用意义。应预先创建好一批可复用的句柄,或改用单句柄轮询(对吞吐要求不高时更稳)。
POST 数据大或含二进制时,CURLOPT_POSTFIELDS 的值类型影响复用稳定性
当 CURLOPT_POSTFIELDS 是数组(如 ['file' => new CURLFile(...)])或字符串(http_build_query() 结果),cURL 底层处理逻辑不同:前者强制使用分块传输(chunked encoding),后者可复用连接但需确保 Content-Length 正确计算。常见问题:
- 传数组时若没设
CURLOPT_HTTPHEADER,cURL 自动加Expect: 100-continue,某些代理或服务端不支持,导致连接中断重试,破坏复用 - 传大字符串时未设
Content-Length,服务端等待超时后断连,下次请求就得重连 - 解决方案:显式设置
Content-Length头(对字符串 payload),或禁用 expect:['Expect:']加入CURLOPT_HTTPHEADER
连接复用不是开关一开就万事大吉,它高度依赖请求头一致性、服务端策略、以及你有没有无意中触发了 cURL 的“强制新建连接”条件。











