PHP: Объектно-ориентированный дизайн
2026-02-26 18:06 Diff
https://ru.hexlet.io/courses/php-object-oriented-design/lessons/collect/theory_unit

В PHP большую популярность завоевала библиотека Collect, которая упрощает обработку коллекций и предоставляет огромное количество функций на все случаи жизни. Пример ниже показывает, как выполнить flatten(), используя Collect.

Всего три строчки, но очень много смысла. Попробуем разобраться. В первой строчке создается объект типа Collection. Создаётся необычным способом — вместо new Collection мы видим обычную функцию. Такой трюк служит одной единственной цели — сделать код компактнее. Это наглядный пример использования паттерна Фабрика.

Объект, который возвращает функция collect(), содержит исходную коллекцию внутри себя и предоставляет свой собственный интерфейс для её изменения. Создав объект, мы можем начать пользоваться самой библиотекой. В примере выше выполняется метод flatten(), который возвращает новую коллекцию. Причем под коллекцией понимается не массив, а именно объект типа Collection, что позволяет продолжить обработку без необходимости повторного оборачивания в collect().

Кроме того, практически каждый метод в Collection возвращает новую коллекцию и не модифицирует исходную (но есть некоторые, которые меняют исходную коллекцию). Такой подход позволяет переиспользовать промежуточные результаты, не боясь случайно сломать код. В примере выше это означает, что сама $collection не изменилась. А значит, мы можем её использовать повторно уже для других вычислений.

В последней строчке $flattened->all() из объекта извлекается результирующий массив. Подобный код нужен почти всегда, когда нативная (встроенная в язык) структура оборачивается в объект. Когда все операции выполнены, тогда обычно нам требуется готовый массив для продолжения работы.

Collect содержит внутри себя все те функции высшего порядка, с которыми мы познакомились ранее, это map(), filter() и reduce().

Map:

Filter:

Reduce:

Fluent Interface

Посмотрите на то, как организована цепочка вызовов в коде ниже.

Схематично цепочка выглядит так: $collection->map(...)->reject(...). Мы уже рассматривали подобный код, когда один объект возвращает другой, но тогда речь шла про то, что объект одного типа возвращает объект другого типа, у которого есть свои методы. В данном же примере методы возвращают объект того же типа (возникает ощущение, что возвращается сам объект, но в изменённой форме). В теории такой подход даёт возможность строить цепочки неограниченной длины: $collection->map(...)->map(...)->map(...). Такую цепочку вызовов принято называть fluent interface (текучий интерфейс).

Кстати в том же JavaScript такие цепочки — основной способ строить вычисления на коллекциях.

Подробнее о том как работает fluent interface – в следующем уроке.

Query Builder

Query Builder — широко распространённый паттерн проектирования, позволяющий собирать сложные запросы по частям. Чаще всего он встречается при работе с базами данных для сбора SQL, либо для коллекций, как в примерах данного урока. Этот паттерн в ОО-языках реализуется с помощью текучего интерфейса (fluent interface).

Его удобство проявляется особенно сильно в тех местах, где логика построения запросов условная. Например, фильтрация товаров в интернет-магазине. Без Query Builder такую выборку реализовать крайне трудно.