Транспорт и пул соединений
Новое соединение — это DNS, TCP и TLS: десятки миллисекунд. Cast старается делать его как можно реже и при этом никогда не отдавать одно соединение двум запросам сразу.
Пул хендлов
Пул хранит хендлы cURL. Открытое соединение живёт внутри хендла: повторный запрос к тому же хосту через тот же хендл идёт по уже открытому соединению.
CurlHandlePool (один на CastClient и все его копии with*())
├── свободные: [h1, h2, h3] хендлы с открытыми соединениями, не больше 16
└── share: DNS + TLS-сессии общий справочник для всех хендлов пулаПуть одного запроса:
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
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.