Промежуточные обработчики HTTP-запросов для приложений Triangle. Пакет предоставляет контракт middleware и загрузчик, который собирает обработчики из конфигурации приложения, маршрута и атрибутов контроллера. Вызов цепочки и преобразование результата в HTTP-ответ выполняет интегрирующее приложение, например Triangle HTTP.
- PHP 8.1 или новее (
^8.1в Composer). triangle/routerверсии^2.0.- Текущая исходная ветка объявляет
triangle/engine^8.1 || ^9.0.
Стабильный Triangle Engine 9 опубликован как версия 9.0.0 20 ноября 2026 года. Ограничение Middleware ^8.1 || ^9.0 разрешает Engine 8.1+ до 9.0 и Engine 9.x. Фактически выбранные версии проверяйте командой composer show triangle/middleware triangle/engine.
composer require triangle/middleware<?php
use Triangle\Middleware\MiddlewareInterface;
final class RequestLogMiddleware implements MiddlewareInterface
{
public function process($request, callable $handler)
{
// Inspect or modify the request before passing it on.
$response = $handler($request);
// Inspect or modify the downstream response.
return $response;
}
}Вызов $handler($request) передаёт запрос следующему обработчику. Middleware может вернуть ответ самостоятельно, не вызывая $handler, либо вернуть результат следующего обработчика. Тип запроса, тип результата и конкретный объект ответа определяются используемым приложением.
MiddlewareInterface не является строгой реализацией PSR-15: параметр запроса и возвращаемое значение не типизированы, а обработчик задан как callable, а не типизированный PSR-15 RequestHandlerInterface. Не предполагайте совместимость с PSR-7/PSR-15 без адаптера и проверки типов запросов/ответов вашего приложения.
Установщик компонента содержит пример файла src/Config/middleware.php с пустым списком для приложения ''. Загрузчик Triangle\Middleware\Bootstrap принимает массив, где ключ — приложение, а значение — список классов middleware с методом process:
<?php
return [
'@' => [RequestLogMiddleware::class],
'api' => [ApiAccessMiddleware::class],
];@ задаёт middleware общего уровня; имя приложения, например api, задаёт обработчики приложения. Записи конфигурации должны быть массивами. При загрузке проверяется наличие метода process; соответствие MiddlewareInterface не обязательно. Если метод отсутствует или структура неверна, загрузчик выбрасывает RuntimeException.
Bootstrap также считывает глобальную конфигурацию Engine, статическую конфигурацию, конфигурацию приложений и плагинов. getMiddleware() добавляет middleware маршрута, атрибута Triangle\Annotation\Middleware на классе/методе контроллера и публичного свойства контроллера middleware, если они заданы. Эти механизмы требуют соответствующих компонентов Triangle и не являются отдельным HTTP-сервером.
getMiddleware() возвращает подготовленный список для дальнейшего оборачивания обработчика. В Engine HTTP список применяется через вложенные вызовы: каждый middleware получает запрос и callable следующего обработчика. Фактическая последовательность зависит от уровня конфигурации и места объявления; проверьте порядок для используемой версии Engine HTTP, прежде чем полагаться на порядок побочных эффектов.
Глобальные обработчики могут отключаться для конкретного вызова параметром withGlobal: false. Регистрация кэшируется в статическом состоянии процесса; повторная загрузка конфигурации в том же процессе добавляет элементы, а не очищает ранее зарегистрированные.
composer test запускает regression suite загрузчика middleware. Проверяются порядок и область действия global, plugin и app middleware, параметр withGlobal: false, а также ошибки некорректной конфигурации. composer lint проверяет синтаксис PHP в исходниках и тестах.
GitHub Actions выполняет эти проверки на PHP 8.1 и 8.5. Поскольку это библиотека, composer.lock не хранится в репозитории: каждый CI запуск разрешает версии по ограничениям composer.json. Тесты проверяют загрузчик и список обработчиков; полный цикл HTTP-запроса с Triangle HTTP здесь не запускается.
Локальный запуск:
composer update --prefer-dist --no-interaction --no-progress
composer validate --no-check-publish --no-interaction
composer lint
composer testДля проверки фактического HTTP-вызова используйте интеграционные тесты приложения с установленными версиями Engine и HTTP-компонента.
AGPL-3.0-or-later. См. LICENSE.