TrueAsync Server ​

(PHP 8.6+, true_async_server 0.6+)

TrueAsync Server — нативное PHP-расширение, которое запускает производительный HTTP-сервер прямо внутри PHP-процесса. Без отдельного daemon, без reverse-proxy, без FastCGI-моста.

Из коробки поддерживает HTTP/1.1 и HTTP/2 на одном TCP-порту. Выбор протокола происходит через ALPN-negotiation (для TLS) или HTTP Upgrade. HTTP/3 работает на том же UDP-порту (QUIC) и анонсируется клиентам через заголовок Alt-Svc.

WebSocket, SSE и gRPC уже спроектированы под ту же модель одного listener'а с детектом протокола, но пока ещё в работе (см. Roadmap).

use TrueAsync\HttpServer;
use TrueAsync\HttpServerConfig;

$server = new HttpServer(
    (new HttpServerConfig())
        ->addListener('0.0.0.0', 8080)
        ->setWorkers(4)
);

$server->addHttpHandler(function ($request, $response) {
    $response->setStatusCode(200)->setBody('Hello, World!');
});

$server->start();

Зачем ​

Цель сервера — раскрыть потенциал конкурентных приложений на PHP.

TrueAsync дал языку настоящие корутины, неблокирующий I/O и пулы соединений. Чтобы этот потенциал реализовался в production-нагрузке, нужен сервер, который изначально спроектирован под эту модель: долгоживущий процесс с event-loop'ом, где каждый запрос получает свою корутину, а планировщик переключается между ними на каждом I/O-ожидании.

TrueAsync Server и есть такой сервер. Никакой прослойки между корутинами и сетью: listener, парсер протокола, диспетчер запросов и обработчик живут в одном процессе и в одном event-loop'е. Соединения с БД переиспользуются через Async\Pool, opcache горячий между запросами, cold-start платится один раз, при start().

Возможности ​

Архитектура: single-threaded event loop ​

Та же модель, что у NGINX, Envoy, Node.js и Rust Tokio/hyper.

Один поток владеет и соединением, и запросом от accept до send. Нет передачи между accept-thread и worker-thread, нет блокировок, нет переключений контекста между ними. Один event-loop принимает соединение, читает байты из сокета, парсит HTTP, диспетчеризует запрос в обработчик и пишет ответ, не покидая поток.

       ┌─────────────────────────────────────────┐
       │              Event Loop Thread          │
       │                                         │
accept ─►  parse  ─►  dispatch  ─►  respond      │
       │     ▲                        │          │
       │     └──── coroutine yield ◄──┘          │
       └─────────────────────────────────────────┘

Неблокирующий I/O делает libuv-реактор (через TrueAsync). Когда корутине нужно подождать файл, БД или следующий WebSocket-кадр, она передаёт управление event-loop, который сразу подбирает следующее готовое событие. Поток никогда не простаивает в read()/recv().

Для масштабирования по ядрам поднимается multi-worker через setWorkers(N): встроенный Async\ThreadPool поднимает N OS-потоков, каждый с собственным независимым event-loop, и SO_REUSEPORT (Linux/BSD) даёт ядру распределять входящие соединения по ним. Никакого shared state, никаких глобальных блокировок.

Где начинать ​

• Быстрый старт: установка и минимальный пример за 5 минут
• Конфигурация: listeners, workers, TLS, таймауты, body streaming, bootloader
• Компрессия: gzip / brotli / zstd, переговоры, BREACH
• Статика и sendFile: StaticHandler, precompressed sidecars, Range
• Streaming: стрим тела запроса и стрим ответа
• Multi-worker: setWorkers(N), bootloader, per-request scope
• Примеры: JSON-API, статика, fan-out, multipart upload
• Архитектура: внутренности

Справочник API ​

• TrueAsync\HttpServer
• TrueAsync\HttpServerConfig
• TrueAsync\HttpRequest
• TrueAsync\HttpResponse
• TrueAsync\StaticHandler
• TrueAsync\SendFileOptions
• TrueAsync\UploadedFile
• TrueAsync\LogSeverity
• Исключения

Альтернативы ​

FrankenPHP — отдельный встраиваемый сервер на Caddy/Go, в котором PHP выступает воркером. Удобен, когда нужны Caddy-фичи (автоматический Let's Encrypt, конфиг через Caddyfile) или интеграция в существующую Caddy-инфраструктуру. TrueAsync Server — нативная альтернатива без Go-runtime: сервер живёт прямо в процессе PHP.