Rivalry2

HTML Diff

0 added 0 removed

Original 2026-01-01

Modified 2026-02-26

1 Архитектура любого серверного веб-фреймворка опирается на особенности протокола HTTP. Сюда входят понятия запроса (request) и ответа (response). Это значит, что каждому веб-фреймворку приходится реализовывать эти объекты у себя, повторяя то, что уже было сделано в других местах.

2 Чтобы избежать такой ситуации, был разработан стандарт PSR7. Цель PSR-7 - предоставить общий набор интерфейсов для фреймворков, чтобы последние могли использовать одинаковые абстракции. Это позволит разработчикам писать переиспользуемый, независимый от фреймворка код. Сам стандарт объемный, и не имеет смысла его дублировать. В этом уроке мы поговорим только о ключевых особенностях.

3 Request и Response с точки зрения стандарта - это абстракция поверх механизмов, встроенных в сам PHP. Например, они полностью заменяют собой суперглобальные массивы, механизм загрузки файлов и многое другое.

4 Объекты запроса и ответа во фреймворке Slim имеют интерфейс, соответствующий стандарту<a>PSR-7</a>. Пример на главной странице фреймворка демонстрирует это:

5 getBody() возвращает специальный объект-поток (stream). Этот объект можно изменять, записывая туда данные.

6 Интерфейсы, описанные в PSR7, эмулируют работу HTTP. С помощью их методов можно извлечь любую информацию из запроса и создать любой ответ.

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

8 Названия заголовков в PSR-7 регистронезависимы. В самом PHP заголовки всегда переводятся в верхний регистр и хранятся в массиве $_SERVER с префиксом HTTP_:

9 <h2>Response</h2>

10 Ответ аккумулирует внутри себя то, что отправится клиенту, но он изначально не пустой, а содержит некоторые разумные умолчания:

11 А вот с изменением все не так просто. Главная отличительная черта этого интерфейса в том, что он построен в иммутабельном (неизменяемом) стиле и реализует<a>текучий интерфейс (fluent interface)</a>. Ответ невозможно изменить. Вместо этого всегда возвращается новый объект:

12 По этой причине во фреймворках, поддерживающих стандарт PSR-7, обработчик запроса всегда должен вернуть объект ответа. Только в этом случае фреймворк узнает о том, как надо ответить на запрос:

13 Единственная часть вResponse, которую можно менять, - тело ответа. Это связано с техническими особенностями работы потоков в самом PHP. Подробнее об этом можно прочитать в<a>документации</a>.

14 При этом PSR7 достаточно низкоуровневый стандарт. У него нет цели сделать работу с объектами ответа и запроса максимально удобной и простой. Задача была в эмуляции поведения HTTP. Поэтому помимо реализации стандартных интерфейсов многие фреймворки создают дополнительные обертки поверх PSR7.

15 Эти обертки дают много прикладных полезных методов. Одну из таких оберток мы начали использовать с самого начала:<a>Slim-Http</a>. Вот лишь небольшой список полезных функций этой библиотеки, которые мы либо использовали, либо будем использовать:

16 <ul><li>Response::write($data) - изменяет ответ</li>

17 <li>Response::withRedirect($url, $status)</li>

18 <li>ServerRequest::getParam($key, $default)</li>

19 <li>ServerRequest::getParsedBody()</li>

20 </ul>