Skip to content

About

Triangle Middleware Component

Topics

Resources

Code of conduct

Contributing

Stars

4 stars

Watchers

1 watching

Forks

Repository files navigation

Triangle Middleware

Packagist version PHP requirement

Промежуточные обработчики HTTP-запросов для приложений Triangle. Пакет предоставляет контракт middleware и загрузчик, который собирает обработчики из конфигурации приложения, маршрута и атрибутов контроллера. Вызов цепочки и преобразование результата в HTTP-ответ выполняет интегрирующее приложение, например Triangle HTTP.

English documentation

Требования и совместимость

  • 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.

About

Triangle Middleware Component

Topics

Resources

Code of conduct

Contributing

Stars

4 stars

Watchers

1 watching

Forks

Releases

Used by

Contributors

Languages