Polling API в PHP 8.6: что меняется для сетевых сервисов и интеграций

В PHP появляется современный механизм ожидания активности потоков. Разбираем его пользу для долгоживущих соединений, показываем код и отделяем сетевую готовность от результата бизнес-операции.

Содержание статьи
  1. 1. Зачем PHP ещё один API ввода-вывода
  2. 2. Где stream_select() начинает мешать
  3. 3. Context, Watcher и состояние соединения
  4. 4. Небольшой пример: дождаться данных в потоке
  5. 5. Готовность сокета — ещё не готовое сообщение
  6. 6. Почему Write нельзя наблюдать постоянно
  7. 7. Что показал тест Tideways
  8. 8. Где это полезно для интеграций и Symfony
  9. 9. API ожидания не заменяет event loop и контроль результата
  10. 10. Можно ли попробовать API на старом PHP
  11. 11. Как проверить пользу для своего сервиса
  12. 12. Источники, версии и проверка примеров

1. Зачем PHP ещё один API ввода-вывода

Представьте сервис, который держит много соединений, но в каждый момент получает данные только от нескольких клиентов. Остальные ждут. Процессу нужно быстро узнавать, где появилась работа, и не тратить основную часть времени на просмотр неактивных соединений.

Такой сценарий возникает у шлюза событий, TCP-адаптера оборудования, собственного протокола обмена и сервиса с долгими соединениями. Это другая нагрузка, чем короткий HTTP-запрос «прочитать несколько строк из PostgreSQL и вернуть JSON».

Повод для статьи — разбор Polling API от Tideways. Мы рассмотрим практические последствия для архитектуры интеграций. Это самостоятельное объяснение с учебным примером; замеры Tideways ниже явно отделены от наших рекомендаций.

Polling здесь означает ожидание готовности ввода-вывода. Это не периодический опрос REST API контрагента и не новый механизм хранения бизнес-событий.

2. Где stream_select() начинает мешать

stream_select() получает массивы потоков, ожидает готовность и оставляет в массивах только сработавшие ресурсы. Если цикл должен снова наблюдать все соединения, исходные наборы приходится готовить заново. Семантика описана в руководстве PHP.

При небольшом числе соединений такая модель вполне понятна. При тысячах открытых потоков стоимость ожидания и подготовки наборов становится отдельным предметом измерений, даже если прикладной код почти ничего не делает.

Есть и ограничение select по номеру файлового дескриптора: типичное значение FD_SETSIZE — 1024. Это не универсальное обещание «можно открыть ровно 1024 клиента»: часть дескрипторов занята другими ресурсами, а значение зависит от платформы и сборки. Повышение ulimit само по себе не устраняет ограничение выбранного механизма ожидания.

При расследовании такого сбоя полезно отделять три причины: лимит открытых файлов процесса, ограничение backend ожидания и нехватку памяти на состояние соединений. Они могут проявляться похожим образом, но требуют разных действий.

3. Context, Watcher и состояние соединения

Новый API использует Io\Poll\Context для регистрации наблюдений и Watcher для работы с конкретным наблюдением. Поток оборачивается в StreamPollHandle; вместе с ним можно передать объект состояния приложения. После ожидания этот объект доступен через getData().

Вместо того чтобы по индексу восстановить связь между массивом готовых ресурсов и своим каталогом клиентов, обработчик получает зарегистрированный контекст соединения. Это полезно, например, когда рядом с сокетом нужно хранить входной буфер и состояние разбора сообщения.

Автоматический выбор backend скрывает платформенный механизм: на Linux доступен epoll, на BSD/macOS — kqueue, на других платформах используются соответствующие поддерживаемые варианты. Это возможности API, описанные в RFC Polling API; availability конкретной сборки нужно проверять в окружении.

Context хранит наблюдения, а wait возвращает готовые Watcher со связанным состоянием соединений
Схема объясняет движение событий готовности. Бизнес-сообщения читает и обрабатывает прикладной код.

4. Небольшой пример: дождаться данных в потоке

Ниже самостоятельный CLI-пример для PHP 8.6 на POSIX-системе с поддержкой stream_socket_pair. Он создаёт локальную пару сокетов, регистрирует чтение на одном конце, пишет короткую строку в другой и ожидает событие. Это проверка API без внешнего сервера, а не реализация полноценного TCP-сервиса.

<?php

use Io\Poll\Context;
use Io\Poll\Event;
use Time\Duration;

$pair = stream_socket_pair(STREAM_PF_UNIX, STREAM_SOCK_STREAM, 0);
if ($pair === false) {
    throw new RuntimeException('Не удалось создать пару сокетов');
}

[$writer, $reader] = $pair;
$watcher = null;

try {
    stream_set_blocking($reader, false);
    $poll = new Context();
    $watcher = $poll->add(
        new StreamPollHandle($reader),
        [Event::Read],
        ['route' => 'demo → receiver'],
    );

    $payload = "order-1542\n";
    if (fwrite($writer, $payload) !== strlen($payload)) {
        throw new RuntimeException('Учебное сообщение записано не полностью');
    }

    $events = $poll->wait(Duration::fromMilliseconds(200));
    foreach ($events as $ready) {
        if ($ready->hasTriggered(Event::Read)) {
            $data = fread($reader, 8192);
            if ($data === false) {
                throw new RuntimeException('Ошибка чтения');
            }
            echo $ready->getData()['route'], ': ', $data;
        }
    }
} finally {
    if ($watcher !== null && $watcher->isActive()) {
        $watcher->remove();
    }
    fclose($reader);
    fclose($writer);
}

Сохраните пример в polling-demo.php и запустите его бинарным PHP 8.6. Здесь StreamPollHandle находится в глобальном namespace, а Context и Event — в Io\Poll.

php polling-demo.php

Тайм-аут wait задаётся через Time\Duration. Он ограничивает одно ожидание, а не время всей бизнес-операции. Сигнатура сверена с stub PHP 8.6 и RFC Duration: ранние варианты Polling RFC использовали другую форму аргументов.

Пустой список событий не доказывает потерю документа: в пределах одного ожидания поток просто мог не стать готовым. Реальному сервису нужны собственные правила срока обработки и завершения.

5. Готовность сокета — ещё не готовое сообщение

Главная архитектурная ошибка — принять сетевое событие за завершённую бизнес-операцию. Готовность к чтению говорит, что можно попробовать прочитать поток; она не обещает целый заказ, валидный JSON или завершённую транзакцию у получателя.

НаблюдениеЧто должен решить прикладной код
Появились байтыГде граница сообщения, хватает ли данных для разбора
Получена часть ответаСохранить буфер и продолжить после следующего события
Соединение закрытоРазобрать оставшиеся данные и определить незавершённые операции
Запись прошла частичноСохранить незаписанный остаток
Получен ответ APIПроверить значение ответа по контракту операции

Для TCP нужно определить framing: длина сообщения, разделитель или формат протокола. Прочитать один chunk и сразу отправить его в обработку как полный документ нельзя без такого контракта.

При закрытии соединения могут оставаться уже полученные байты. Обработчик ошибок и HangUp должен учитывать протокол и буферы, а не просто выбрасывать всё накопленное. Поэтому короткий пример выше намеренно не назван production-сервером.

6. Почему Write нельзя наблюдать постоянно

Сокет часто готов принять данные даже тогда, когда приложению нечего отправлять. Если постоянно включать наблюдение за записью, цикл может регулярно просыпаться без полезной работы.

Практическое правило: добавлять Event::Write, когда есть выходной буфер, и убирать после его опустошения. Сама запись выполняется неблокирующе, с учётом возможного частичного результата.

use Io\Poll\Event;
use Io\Poll\Watcher;

// Вызывается при изменении состояния выходного буфера.
function updateWriteInterest(Watcher $watcher, bool $hasPendingBytes): void
{
    $watcher->modifyEvents(
        $hasPendingBytes
            ? [Event::Read, Event::Write]
            : [Event::Read],
    );
}

Отдельно ограничьте размер буфера. Если получатель читает медленнее, чем источник присылает сообщения, одно эффективное ожидание не спасёт от роста памяти. Нужны backpressure, лимиты и понятное решение: приостановить приём, сохранить работу в очередь или завершить соединение по правилам протокола.

Такое поведение стоит проверять на медленном клиенте, а не только на локальном echo-тесте. Оно влияет и на ресурсы процесса, и на возможность пережить недоступность контрагента.

7. Что показал тест Tideways

В исходном эксперименте Tideways сравнили echo-серверы со stream_select() и новым API. При восьми активных соединениях и 900 простаивающих throughput вырос примерно в 3,88 раза, а p99 задержки составил около 34% от результата старого варианта. Новый вариант также прошёл сценарий с 5000 простаивающих соединений.

Это чужой замер конкретной сетевой нагрузки, не наш бенчмарк и не обещание ускорения PHP-приложения в 3,88 раза. Echo-сервер хорошо выявляет стоимость ожидания соединений; он не моделирует тяжёлый SQL, бизнес-валидацию и внешние API. В сравнении участвовали разные версии runtime, поэтому коэффициент нельзя выдавать за изолированную универсальную стоимость одного вызова.

Наше прикладное следствие: если производительность ухудшается именно с ростом числа открытых, почти неактивных соединений, механизм ожидания стоит включить в план диагностики. Если основное время уходит в SQL, сначала исследуйте SQL.

8. Где это полезно для интеграций и Symfony

Рассмотрим несколько проектных сценариев. Это примеры возможного применения API, а не заявление, что перечисленные продукты уже используют новый backend.

СценарийПотенциальная пользаЧто всё равно потребуется
TCP-шлюз оборудованияОжидать активность большого числа подключенийFraming, лимиты, тайм-ауты и обработка отключений
Шлюз событий с долгими соединениямиСнижать цену ожидания неактивных клиентовВыходные буферы и backpressure
Собственный сетевой адаптерСвязать событие с объектом состоянияПротокол, повторное подключение и наблюдаемость
Обычный Symfony HTTP endpointНет автоматической выгоды от нового userspace APIИзмерить SQL, ORM, HTTP-клиент и прикладную работу

Для готового Symfony-приложения обновление PHP и переписывание модели исполнения — разные решения. Появление Context не делает синхронные вызовы HTTP или DBAL неблокирующими. Поддержку API выбранной библиотекой надо проверять отдельно.

В длинном обработчике событий особенно опасна тяжёлая синхронная работа внутри callback: пока она выполняется, остальные соединения могут ждать. CPU-задачи, длительные SQL и обработку документов стоит отделять от сетевого приёма по требованиям сервиса.

Если интересует цена ORM в запросе, это другой слой: Profiler и Advisor ModernORMBundle помогают исследовать SQL, flush и hydration. Polling API не заменяет эти измерения.

9. API ожидания не заменяет event loop и контроль результата

Регистрировать потоки и получать готовые Watcher — только часть долгоживущего сервиса. Ещё нужны расписание задач, shutdown, обработка сигналов, retry/backoff, ограничение параллелизма и логирование. Для проекта выбор зрелого event loop часто полезнее собственного инфраструктурного слоя; пригодность конкретной библиотеки проверяется отдельно.

Базовый тайм-аут wait не равен индивидуальным таймерам всех операций. Для каждой активной операции нужно хранить deadline и принимать решение о просрочке. Развитие API, включая дополнительные типы handles, обсуждается в отдельном RFC Polling API Additions; этот план нельзя считать уже доступным контрактом PHP 8.6.

Для интеграции полезно разделить три факта: соединение готово, ответ получен, документ обработан. Последний требует бизнес-подтверждения и устойчивого ID операции. Эта тема подробно разобрана в статье API ответил 200, но заказ не дошёл.

Эффективное ожидание уменьшает инфраструктурные расходы. Оно не устраняет дубли, не даёт exactly-once и не доказывает доставку документа в 1С или WMS.

10. Можно ли попробовать API на старом PHP

У Symfony есть symfony/polyfill-io-poll для PHP от 8.1. Он даёт совместимую поверхность API через stream_select(), поэтому это путь к совместимости кода, а не способ получить epoll на старом runtime. Для Time\Duration на PHP до 8.6 нужен polyfill-time.

composer require symfony/polyfill-io-poll symfony/polyfill-time

Пакеты устанавливаются в проект, где вы экспериментируете с API, а не требуются для всех Symfony-приложений. В standalone-скрипте нужно подключить vendor/autoload.php.

Polyfill не поддерживает edge-triggering, а часть событий закрытия и ошибок отличается от нативного backend. Поэтому успешный небольшой пример ещё не подтверждает совместимость production-протокола на всех платформах.

Перед переносом проверьте используемые события, семантику закрытия соединений и поведение выбранной версии пакета. Не смешивайте цифры нативного Linux backend с результатами PHP-polyfill.

11. Как проверить пользу для своего сервиса

  1. Снимите профиль нагрузки. Сколько соединений открыто, сколько активно, каков размер сообщений.
  2. Отделите ожидание от работы. Измеряйте обработку, SQL и внешние вызовы отдельно от polling.
  3. Меняйте один фактор. Сравните реализации на одинаковом runtime и оборудовании, с одинаковыми буферами и логикой.
  4. Измеряйте хвост задержки. Помимо throughput смотрите p95/p99, ошибки и время восстановления.
  5. Добавьте неприятные сценарии. Медленный читатель, частичная запись, обрыв соединения, переподключение, рост очереди.
  6. Проверьте бизнес-границу. Как сервис узнаёт, что конкретная операция завершена, и что делает при неизвестном исходе.

Для шлюза с большим числом ожидающих соединений Polling API даёт повод пересмотреть нижний уровень сетевого цикла. Для обычного приложения первый шаг прежний: найти реальное узкое место и измерить изменение на своём сценарии.

12. Источники, версии и проверка примеров

Материал подготовлен 19 ноября 2026 года. На момент проверки php.net указывал плановую дату GA PHP 8.6 — 19 ноября; наличие опубликованного финального релиза и готовность расширений проверяйте перед обновлением. Сигнатуры примеров сверены с веткой PHP-8.6, а синтаксис проверен локальным PHP 8.5. Нативный пример PHP 8.6 и нагрузочный тест Tideways при подготовке статьи мы не запускали.

ModernERP Integration Monitor

Узнавайте о сбоях обменов раньше, чем о них сообщат сотрудники

Ошибки, задержки и история обменов между 1С, CRM, WMS и API — в одном сервисе. Контролируйте критичные интеграции с Integration Monitor.

Посмотреть Integration Monitor ↗

Работает на наших серверах · До 15 интеграций · 90 дней истории