Пакет · cast

Параллельные запросы

Независимые запросы не нужно ждать по очереди. sendAll() отправляет их одновременно, и общее время равно времени самого медленного, а не сумме.

sendAll

php
$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 запросов сразу. Остальные ждут, пока освободится место.

php
$client->withConcurrency(32);              // для клиента
$client->sendAll($requests, concurrency: 4);   // для одного вызова

Ограничение защищает и сервер, к которому вы обращаетесь, и ваш процесс.

Генератор вместо массива

Запросы можно отдавать генератором. Он читается по мере отправки, поэтому список из 10 000 запросов не нужно держать в памяти целиком:

php
$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:

php
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(). Один клиент безопасно используется всеми: он неизменяем, а каждый запрос берёт себе отдельное соединение.

php
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();