PHP curl 多句柄怎样并行请求多个地址

多个接口需要同时请求时，逐个调用 curl_exec() 会让后一个地址等待前一个地址结束。PHP 的 curl_multi 方案把多个 easy handle 放进一个 multi handle，由 curl_multi_exec() 反复推进传输，再用 curl_multi_info_read() 找到已经完成的请求。这样可以把等待时间重叠起来，但它不等于无限并发，超时、失败和连接数仍要单独控制。

官方地址：https://www.php.net/

先把每个地址封装成独立句柄

并行请求的第一步不是直接写循环，而是建立地址与句柄的映射。每个句柄都设置连接超时和总超时，并把响应内容留在内存中；如果业务需要流式写文件，应改用写入回调，而不是把大响应全部堆在内存里。

 'https://api.example.com/profile',
    'orders'  => 'https://api.example.com/orders?limit=20',
    'quota'   => 'https://api.example.com/quota',
];

$multi = curl_multi_init();
$handles = [];

foreach ($urls as $key => $url) {
    $ch = curl_init($url);
    curl_setopt_array($ch, [
        CURLOPT_RETURNTRANSFER => true,  // 把响应体交给 curl_multi_getcontent。
        CURLOPT_CONNECTTIMEOUT => 3,     // 连接建立超过 3 秒就失败。
        CURLOPT_TIMEOUT => 8,            // 单个请求最长执行 8 秒。
        CURLOPT_HTTPHEADER => ['Accept: application/json'],
    ]);
    curl_multi_add_handle($multi, $ch);
    $handles[$key] = $ch;
}
?>

用 exec 循环推进并行传输

加入句柄后，先调用一次 curl_multi_exec()，再在 $running 不为零时继续推进。curl_multi_select() 会等待连接可读写，避免 CPU 在没有网络进展时持续空转。它可能返回负数，遇到这种情况短暂让出执行权后再推进即可。

 0) {
        // 等待网络事件，减少无效轮询；负数表示当前没有可等待的 fd。
        $ready = curl_multi_select($multi, 1.0);
        if ($ready === -1) {
            usleep(1000);
        }
    }
} while ($running > 0);
?>

这里的“并行”是 IO 等待被重叠处理，并不是 PHP 代码同时执行多个线程。慢地址仍可能拉长整体耗时，所以生产环境还应按批次限制同时加入的句柄数量。

完成后同时检查三类结果

传输结束不代表业务成功。cURL 错误码反映传输层，HTTP 状态码反映服务端响应，响应体才是接口业务数据。用 curl_multi_info_read() 读取完成消息时，应通过返回的 handle 找回业务键。

 $errorNo,
        'curl_error' => $errorNo === 0 ? null : curl_error($ch),
        'http_code' => (int) curl_getinfo($ch, CURLINFO_HTTP_CODE),
        'body' => curl_multi_getcontent($ch),
    ];
}

foreach ($handles as $ch) {
    // 先从 multi 中移除，再关闭 easy handle，避免资源残留。
    curl_multi_remove_handle($multi, $ch);
    curl_close($ch);
}
curl_multi_close($multi);
?>

并发数量、超时与回滚清单

如果调用接口会产生写入、扣费或状态变更，不要因为一次网络超时就无条件重试；先确认接口是否支持幂等键。若响应体很大，改用临时文件或回调接收，并给整批请求设置上限。

常见问题

curl_multi_exec 返回成功就代表接口成功吗

不代表。它主要表示 multi 层驱动没有立即报错，仍要检查每个句柄的 cURL 错误码、HTTP 状态和业务字段。

为什么完成顺序和输入顺序不一样

多个请求独立推进，哪个先收到完整响应就先产生完成消息。需要保持输入顺序时，用地址键写入结果，最后按原数组遍历输出。

curl_multi_select 一定要调用吗

不是绝对必须，但没有等待机制时容易形成高频空转。只要还有运行中的句柄，就应优先等待 IO，遇到负数再短暂让出 CPU。

多个请求失败时能否整体重试

不建议无条件整体重试。按句柄记录失败原因，只对连接重置、临时网关错误等明确可重试项处理，并为写操作配合幂等策略。