Параллельные запросы
Независимые запросы не нужно ждать по очереди. sendAll() отправляет их одновременно, и
общее время равно времени самого медленного, а не сумме.
sendAll
$responses = $client->sendAll([
'user' => $client->get('users/42'),
'orders' => $client->get('orders', ['user' => 42]),
'stats' => $client->get('stats/42'),
]);
$user = $responses['user']->throw()->json();
$orders = $responses['orders']->json();- Ответы приходят с теми же ключами и в том же порядке, что запросы. Ключи любые: строки, числа.
- Каждый запрос проходит полную цепочку: middleware, повторы, редиректы,
sinkTo(),onProgress(). - 4xx/5xx — это ответы, они в результате, как и при
send().
Сколько одновременно
По умолчанию — не больше 16 запросов сразу. Остальные ждут, пока освободится место.
$client->withConcurrency(32); // для клиента
$client->sendAll($requests, concurrency: 4); // для одного вызоваОграничение защищает и сервер, к которому вы обращаетесь, и ваш процесс.
Генератор вместо массива
Запросы можно отдавать генератором. Он читается по мере отправки, поэтому список из 10 000 запросов не нужно держать в памяти целиком:
$requests = (function () use ($client, $ids) {
foreach ($ids as $id) {
yield $id => $client->get("users/{$id}");
}
})();
foreach ($client->sendAll($requests, concurrency: 8) as $id => $response) {
// ...
}Ответы всё равно собираются в массив и возвращаются в конце.
Ошибки
Если часть запросов не получила ответа (сеть, таймаут), sendAll() дожидается всех
остальных и только потом бросает BatchException:
use Flytachi\Winter\Cast\Exception\BatchException;
try {
$responses = $client->sendAll($requests);
} catch (BatchException $e) {
$responses = $e->responses(); // полученные ответы — с ключами запросов
$failures = $e->failures(); // ключ => исключение
}Один упавший запрос не отменяет остальные: полученные ответы не теряются.
Как это работает
Код вызова одинаков в любой среде. Механизм выбирается сам:
| Где вызван | Как выполняется |
|---|---|
| внутри корутины Swoole | каждый запрос — своя корутина; cURL не блокирует воркер благодаря хукам Swoole |
| PHP-FPM, CLI, Swoole вне корутины | каждый запрос — свой Fiber; когда запрос ждёт сеть, его хендл добавляется в общий curl_multi, а Fiber приостанавливается |
Fiber нужны затем, чтобы middleware и повторы оставались обычным синхронным кодом:
$next($request) возвращает ответ, а ожидание сети при этом общее. Паузы между повторами
тоже не блокируют остальные запросы.
Подробнее — в Транспорте и пуле соединений.
Внутри корутин без sendAll
В Swoole можно и просто запускать корутины, каждая со своим send(). Один клиент безопасно
используется всеми: он неизменяем, а каждый запрос берёт себе отдельное соединение.
use Swoole\Coroutine;
use Swoole\Coroutine\WaitGroup;
$group = new WaitGroup();
foreach ($ids as $id) {
$group->add();
Coroutine::create(function () use ($client, $id, $group) {
$client->get("users/{$id}")->send();
$group->done();
});
}
$group->wait();