PHP: Eloquent (ORM)
2026-02-26 14:58 Diff
https://ru.hexlet.io/courses/php-orm-eloquent/lessons/query-builder/theory_unit

Одна из задач, которую берут на себя ORM – это построение произвольных SQL-запросов в базу данных. Вот как это делается с помощью Eloquent:

Такая цепочка вызовов поэтапно конструирует необходимый запрос. Метод get() указывает на окончание запроса и выполняет его в базе данных. Eloquent автоматически конвертирует вернувшиеся данные в объекты модели и возвращает их наружу. Если нужно вернуть только одну запись, то вместо get() можно использовать first():

Порядок вызовов функций не важен. Сначала можно сортировать, а потом фильтровать:

Eloquent самостоятельно расставит все части в правильном порядке. Несмотря на такую заботу, всё же рекомендуется там, где это возможно соблюдать ожидаемый порядок вызовов. Это упростит чтение кода.

Многие вызовы могут накапливаться. Цепочка из where породит в SQL-запросе одну часть WHERE, где все условия объединены с помощью оператора AND.

Обратите внимание на то, что первый вызов всегда идёт через статический метод самой модели. Все дальнейшие вызовы выполнятся из объекта, который возвращает первый вызов. Это касается любого метода и не зависит от порядка вызовов:

Будьте осторожны: в Eloquent каждый вызов в цепочке изменяет объект запроса. Это значит, что каждый отдельный запрос нужно строить заново, либо использовать клонирование.

В языке запросов Eloquent есть по методу на каждую часть SQL. Некоторые из них в таблице ниже:

Мы рассмотрим только некоторые из них.

Where – наиболее часто используемая часть при построении запросов. Ниже примеры кода и описание:

У метода Where много специализированных версий:

Зачем?

Для чего нужен такой язык, почему недостаточно SQL? На это есть несколько разных причин:

  • Универсальность. Eloquent способна генерировать SQL, подходящий под конкретную базу данных. Построение запросов же не привязано к базе данных. Хотя это не отменяет ситуаций, в которых приходится выполнять "сырые" запросы в базу данных.
  • Безопасность. Такой способ построения запросов автоматически экранирует все подставляемые значения.
  • Автоматическая конвертация. Если делать запросы руками, то придётся руками же описывать как выбранные данные должны лечь на свойства конкретной модели. Это довольно серьёзная работа, которую лучше поручить ORM (во многом она для этого и создавалась).
  • Динамические запросы. SQL очень плохо подходит для динамических запросов, когда они конструируются по условиям. Такое часто встречается в фильтрах.