Пакет · cast

Транспорт и пул соединений

Новое соединение — это DNS, TCP и TLS: десятки миллисекунд. Cast старается делать его как можно реже и при этом никогда не отдавать одно соединение двум запросам сразу.

Пул хендлов

Пул хранит хендлы cURL. Открытое соединение живёт внутри хендла: повторный запрос к тому же хосту через тот же хендл идёт по уже открытому соединению.

text
CurlHandlePool  (один на CastClient и все его копии with*())
├── свободные: [h1, h2, h3]    хендлы с открытыми соединениями, не больше 16
└── share: DNS + TLS-сессии    общий справочник для всех хендлов пула

Путь одного запроса:

text
acquire()   взять свободный хендл; нет свободных — создать новый
↓
выполнить запрос
↓
release()   сбросить опции (соединение остаётся открытым) и вернуть в пул
          • свободных уже 16 — хендл закрывается
          • запрос упал с ошибкой — хендл закрывается, следующий возьмёт свежий
  • Хендл принадлежит одному запросу. Пока он занят, его нет среди свободных, поэтому два запроса никогда не пишут в одно соединение.
  • Пул не ограничивает запросы. Число 16 — сколько свободных хендлов хранить про запас, а не сколько запросов выполнять одновременно. Нет свободного — создаётся новый, без очереди и ожидания.
  • Клиенты не связаны. У каждого new CastClient() свой пул; копии через with*() делят пул исходного.

Общий кеш: curl_share

Хендлы одного пула делят через curl_share:

  • DNS — адрес, найденный одним хендлом, знают все (кеш cURL — 60 секунд);
  • TLS-сессии — новый хендл к знакомому серверу делает короткое рукопожатие вместо полного.

Это помогает там, где соединение не переиспользовалось: новый хендл при пиковой нагрузке, хендлы после sendAll().

Общий кеш соединений (CURL_LOCK_DATA_CONNECT) и persistent-share PHP 8.5 не используются сознательно. Выигрыш от них невелик, а под Swoole с curl-native у каждой корутины свой цикл ожидания, и деление соединений между ними дало бы трудноуловимые сбои.

PHP-FPM и Swoole

PHP-FPM Swoole
Сколько живёт пул пока жив клиент — обычно один запрос приложения весь срок воркера, если клиент — бин
Переиспользование соединений внутри одного запроса приложения между всеми запросами воркера
Одновременные запросы Fiber + общий curl_multi каждая корутина берёт свой хендл
Ожидание сети curl_exec или curl_multi_select хуки Swoole: корутина уступает место

В Swoole acquire() и release() не содержат точек ожидания, поэтому корутина не может переключиться посреди них. Гонки за хендл нет, блокировки не нужны.

sendAll без Swoole: Fiber и curl_multi

text
sendAll([a, b, c])
├─ Fiber a: middleware → повторы → транспорт → хендл в curl_multi → приостановка
├─ Fiber b: …                                → хендл в curl_multi → приостановка
├─ Fiber c: …                                → хендл в curl_multi → приостановка
└─ цикл: curl_multi_exec / select → ответ готов → возобновить его Fiber

Код middleware и повторов остаётся синхронным: $next($request) просто возвращает ответ. Пауза между повторами — тоже приостановка Fiber по таймеру, остальные запросы в это время идут. Если sendAll() вызван изнутри другого sendAll() (например, из middleware), вложенные запросы выполняются по очереди, но через тот же внешний цикл — ничего не блокируется.

Пока хендл внутри curl_multi, соединение хранится в кеше multi, а он закрывается после sendAll(). Хендлы возвращаются в пул без соединений; следующий запрос подключится заново, но благодаря share — без DNS и с быстрым TLS.

Сервер перезапустился

  • запросы, отправленные, пока сервер лежит, получают NetworkException («Could not connect»), а хендл выбрасывается;
  • как только сервер поднялся, следующий запрос проходит: клиент ничего не «запоминает»;
  • соединение из пула, которое сервер закрыл, cURL проверяет перед использованием и молча открывает новое; если сервер закрыл его в момент отправки и ответа не было, cURL сам переподключается один раз;
  • сменился IP (новый контейнер) — до минуты адрес может браться из DNS-кеша; нужно быстрее — withCurlOptions([CURLOPT_DNS_CACHE_TIMEOUT => 10]);
  • TLS-сессию сервер не узнал — делается полное рукопожатие, без ошибки.

Чтобы короткий перезапуск вообще не доходил до вашего кода, включите повторы: RetryPolicy::exponential(3, 500) — ошибка подключения считается временной.

HTTP/2

По TLS используется HTTP/2, если cURL собран с его поддержкой и сервер его предлагает (ALPN). Иначе и по http:// — HTTP/1.1. Версия ответа — getProtocolVersion() и info()->protocol.