php 原生 curl 扩展不支持真正的并发,必须借助 curl_multi 系列函数构建多句柄循环来实现。具体做法是初始化多个 curlopt_url 不同的 curlhandle,将它们加入 curl_multi_add_handle 后,在 curl_multi_exec 循环中配合 curl_multi_select 等待网络就绪,最后通过 curl_multi_getcontent 收集结果。

如何正确配置和启动多句柄循环?
配置的核心在于将多个独立的 cURL 句柄统一交给 curl_multi_init 管理。启动后不能直接死循环调用 curl_multi_exec,否则会导致 CPU 空转;必须结合 curl_multi_select 阻塞等待 IO 事件,当有数据可读或连接建立时再执行下一次轮询。

$mh = curl_multi_init();
$handles = [];
// 假设请求三个不同 URL
$urls = ['http://api.example.com/a', 'http://api.example.com/b', 'http://api.example.com/c'];
foreach ($urls as $url) {
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_TIMEOUT, 5);
curl_multi_add_handle($mh, $ch);
$handles[(int)$ch] = $ch;
}
$running = null;
do {
curl_multi_exec($mh, $running);
if ($running > 0) {
curl_multi_select($mh, 1.0); // 等待活动,超时1秒
}
} while ($running > 0);
// 获取结果
$results = [];
foreach ($handles as $id => $ch) {
$results[$id] = curl_multi_getcontent($ch);
curl_multi_remove_handle($mh, $ch);
curl_close($ch);
}
如何处理请求完成后的资源清理与结果提取?
当 curl_multi_exec 返回的 $running 变为 0 时,表示所有请求已完成。此时需要遍历之前保存的句柄数组,使用 curl_multi_getcontent 提取每个句柄的响应体,并调用 curl_multi_remove_handle 从多句柄中移除该句柄以防止内存泄漏,最后关闭单个 cURL 句柄。
使用官方Model Context Protocol PHP SDK将PHP应用程序功能暴露为MCP工具、资源和提示,用于代理工作流。
立即学习“PHP免费学习笔记(深入)”;

// 接上文循环结束后
foreach ($handles as $id => $ch) {
$error = curl_error($ch);
if ($error) {
echo "Error: $error\n";
} else {
$results[$id] = curl_multi_getcontent($ch);
}
curl_multi_remove_handle($mh, $ch);
curl_close($ch);
}
curl_multi_close($mh);
如果某个请求超时,curl_multi_getcontent 会返回什么?
如果设置了 CURLOPT_TIMEOUT 且请求超时,curl_multi_getcontent 不会抛出异常,而是返回一个空字符串 ""。要区分是成功返回空内容还是超时失败,应检查 curl_getinfo($ch, CURLINFO_HTTP_CODE) 或 curl_error($ch)。超时时 curl_error 通常返回 "Operation timed out after ... milliseconds"。


















