Rivalry2

HTML Diff

1 added 1 removed

Original 2026-01-01

Modified 2026-02-26

1 При разработке веб-приложений разработчики сталкиваются с задачами, которые нужно решать на каждом этапе обработки запроса. Например, если у нас есть несколько маршрутов, которые требуют аутентификации, или если нам нужно логировать все входящие запросы, то реализация этой логики в каждом маршруте может привести к дублированию кода и усложнению поддержки приложения. Это также увеличивает вероятность ошибок, так как любой измененный маршрут необходимо будет обновить в нескольких местах. Использование мидлвар позволяет решить эти проблемы.

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

3 - В этом уроке мы р��ссмотрим, как создавать и использовать мидлвары в Slim, а также изучим примеры их применения

3 + В этом уроке мы рассмотрим, как создавать и использовать мидлвары в Slim, а также изучим примеры их применения

4 <h2>Оборачивание</h2>

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

6 Представим, что у нас есть функция, которая прибавляет 5 к аргументу:

7 Наша задача расширить поведение этой функции, при этом не меняя саму функцию. Например, мы хотим прибавлять 5 к удвоенному значению аргумента. Чтобы решить эту задачу, мы можем написать новую функцию, которая будет внутри себя использовать уже существующую:

8 Точно так же мы можем расширить и вторую функцию:

9 В общем случае расширение функции выглядит так:

10 Чтобы расширить поведение функции, нужно создать новую функцию, которая будет использовать исходную. Главное условие - интерфейсы обоих методов должны совпадать: количество и тип аргументов, а также тип возвращаемого результата должны быть одинаковыми. Тогда вы можете просто заменить в коде вызов одной функции на вызов другой, обернутой, и код продолжит работать без изменений, поскольку интерфейс остался прежним. В этом случае код, использующий вашу новую функцию, не заметит, что она обернута и его не потребуется переписывать. Этот подход также называется декорированием и описывается в справочниках по шаблонам проектирования как "паттерн Декоратор".

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

12 <h2>Использование мидвар</h2>

13 Фреймворк Slim имеет встроенную поддержку мидлвар. Для подключения мидлвар в Slim используются метод add()

14 Рассмотрим пример кода с подключением мидлвары:

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

16 Каждая мидлвара представляет собой анонимную функцию, которая принимает два аргумента:

17 <ul><li>Объект Request, который представляет собой запрос</li>

18 <li>Объект RequestHandler позволяет определять, как обрабатывать входящие запросы и генерировать ответы</li>

19 </ul>Функция обязательно должна вернуть объект класса, реализующего Psr\Http\Message\ResponseInterface

20 Каждый раз, когда мы используем add(), очередная мидлвара добавляется к приложению. Slim добавляет мидлвары в виде концентрических слоев, окружающих основное приложение. Каждая новая мидлвара окружает все существующие слои.

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

22 Сначала запрос попадает в самый внешний слой, затем в следующий слой, и так далее, пока не попадает в само приложение. После того как приложение обработает соответствующий запрос, полученный объект Response выходит из приложения и проходит по слоям мидвар ПО изнутри наружу. В конце концов, конечный объект Response выходит из внешнего промежуточного ПО, сериализуется в HTTP-ответ и возвращается клиенту

23 В примере выше мы подключили мидлвары, одна из которых выводит в консоль сообщение, а другая добавляет кастомный заголовокX-Custom-Headerв каждый ответ.

24 Запустим сервер и сделаем запрос:

25 При этом в консоли, где запущено приложение, мы можем увидеть вывод:

26 <h2>Терминальная мидлвара</h2>

27 Далеко не всегда мы хотим двигаться вглубь по всей цепочке добавленных мидлвар. Более того, в какой-то момент одна из мидлвар должна взять обработку запроса на себя. Чтобы завершить обработку, мидлвар может создать и вернуть ответ, не передавая управление следующему мидлвару или обработчику. Это прекращает движение по цепочке, пропуская оставшиеся мидлвары для текущего запроса, и происходит отправка ответа клиенту

28 Такой подход полезен, когда необходимо остановить выполнение дальнейших мидлвар или маршрутов в случае ошибки аутентификации или других условий, при которых дальнейшая обработка не имеет смысла. Например, можно создать мидлвару для проверки наличия определенного параметра в запросе, и если параметр отсутствует, отправить ответ с ошибкой, пропустив выполнение остальных мидлвар и обработчиков.

29 Запустим приложение и сделаем запрос:

30 Видим, что выполнение остановилось на первой мидлваре и сразу вернулся ответ

31 У такого поведения, когда есть цепочка функций и любая из них в процессе обработки может принять решение остановки цепочки и возврата ответа, есть имя. Такие цепочки называют<a>chain responsibility</a>, и это тоже паттерн