README

🇷🇺 Русский · 🇬🇧 English · 🇩🇪 Deutsch · 🇫🇷 Français · 🇪🇸 Español · 🇮🇹 Italiano

CloudCastle Middleware

PSR-15 диспетчер middleware: пропускает запрос через неизменяемую очередь обработчиков к финальному handler'у. Адаптеры для замыканий и ленивое разрешение. Одни PSR-контракты в зависимостях — работает с любым PSR-7 стеком.

Установка

composer require cloud-castle/middleware

Требуется PHP 8.1+. Зависит только от PSR-интерфейсов (http-message, http-server-handler, http-server-middleware).

Быстрый старт

<?php

use CloudCastle\Middleware\CallableMiddleware;
use CloudCastle\Middleware\CallableRequestHandler;
use CloudCastle\Middleware\Dispatcher;

// Финальный обработчик очереди.
$fallback = new CallableRequestHandler(
    static fn ($request) => new Response(200, [], 'Готово'),
);

// Очередь: middleware выполняются в порядке добавления.
$dispatcher = new Dispatcher(
    $fallback,
    new CallableMiddleware(static function ($request, $handler) {
        $response = $handler->handle($request->withAttribute('id', 42));

        return $response->withHeader('X-Trace', 'on');
    }),
);

// Диспетчер неизменяем: with* возвращает копию.
$dispatcher = $dispatcher->withMiddleware($authMiddleware);

$response = $dispatcher->handle($serverRequest);

Возможности

PSR-15 Dispatcher — реализует RequestHandlerInterface, проводит запрос через очередь MiddlewareInterface к финальному обработчику. Неизменяем: один диспетчер безопасно переиспользовать, withMiddleware() даёт копию.
CallableMiddleware — обёртка замыкания fn ($request, $handler): ResponseInterface в middleware без отдельного класса.
CallableRequestHandler — обёртка замыкания fn ($request): ResponseInterface в обработчик; удобно как финальный handler очереди.
LazyMiddleware — ленивое разрешение middleware из фабрики (например, из контейнера) с кэшированием: фабрика вызывается лишь если очередь дошла до шага.

Сравнение с аналогами

Возможность	middleware	relay/relay	laminas/stratigility	middlewares/utils	northwoods/broker	equip/dispatch
PSR-15 диспетчер	✅	✅	✅	✅	✅	✅
Неизменяемая очередь	🏆 ✅	⚠️	⚠️	✅	❌	❌
Адаптер замыканий	✅	⚠️	✅	✅	⚠️	⚠️
Ленивое разрешение	🏆 ✅	✅	✅	❌	✅	❌
Runtime-зависимостей	🏆 3 (PSR)	2	4+	5+	3	3
Контейнер обязателен	🏆 нет	нет	нет	нет	да	да

Когда применять. middleware уместен там, где нужен предсказуемый PSR-15 конвейер без привязки к фреймворку и контейнеру: точки входа приложения, композиция сквозной логики (аутентификация, CORS, трассировка). Если нужны готовые наборы middleware «из коробки» (CORS, сжатие, кэш) — посмотрите middlewares/*: это их сильная сторона, здесь она сознательно не дублируется, пакет даёт только ядро диспетчеризации.

Разработка

composer install
composer check    # линтеры + статический анализ + тесты
composer fix      # автоисправления (Rector, PHP CS Fixer, PHPCBF)
composer ci       # полный CI-пайплайн локально

Полный список команд с описаниями: composer run-script --list.

Документация

Репозиторий: https://gitverse.ru/cloud-castle/middleware
История изменений: CHANGELOG.md
Как внести вклад: CONTRIBUTING.md
Кодекс поведения: CODE_OF_CONDUCT.md
Политика безопасности: SECURITY.md

Лицензия

🇷🇺 Русский · 🇬🇧 English · 🇩🇪 Deutsch · 🇫🇷 Français · 🇪🇸 Español · 🇮🇹 Italiano

cloud-castle / middleware

Maintainers

Package info

Statistics

Security