Зарегистрируйтесь для доступа к 15+ бесплатным курсам по программированию с тренажером

Построение запросов (Query Builder) PHP: Eloquent (ORM)

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

<?php

// SELECT * FROM users WHERE name = "John" ORDER BY name DESC LIMIT 10
$users = User::where('name', 'John') // WHERE
    ->orderBy('name', 'desc') // ORDER BY
    ->take(10) // LIMIT
    ->get();

foreach ($users as $user) {
    echo $user->first_name;
}

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

<?php

// SELECT * FROM users WHERE name = "John" LIMIT 1
$user = User::where('name', 'John')->first();

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

<?php

$users = User::orderBy('name', 'desc')
    ->where('name', 'John')
    ->get();
// SELECT * FROM users WHERE name = "John" ORDER BY name DESC

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

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

<?php

User::where('name', 'John')->where('age', '=', 34)->where('city', 'Moscow')->get();
// WHERE name = "John" AND age = 34 AND city = "Moscow"

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

<?php

// Статический метод orderBy
User::orderBy('name', 'desc')->where('name', 'John');

// Статический метод where
User::where('name', 'John')->orderBy('name', 'desc');

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

<?php
$scope = User::orderBy('name', 'desc');
$scope->where('name', 'John'); // этот вызов изменяет $scope
print_r($scope->toSQL());
// SELECT * FROM users WHERE name = "John" ORDER BY name DESC

$scope->where('age', '18');
print_r($scope->toSQL());
// SELECT * FROM users WHERE name = "John" AND age = 18 ORDER BY name DESC

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

метод sql
where WHERE
orderBy ORDER
take LIMIT
select SELECT
skip OFFSET
groupBy GROUP

Мы рассмотрим только некоторые из них. Все остальное достаточно легко понять из документации если вы знаете SQL. Если вы его не знаете, то самое время пройти курс основы баз данных.

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

<?php

// WHERE votes = 100
// Равносильно User::where('votes', 100);
User::where('votes', '=', 100);

// WHERE votes >= 100
// Кроме >= можно использовать все что поддерживается базой данных.
User::where('votes', '>=', 100);

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

<?php

// orWhere – соединяется с другими вызовами "where" через оператор OR
$users = User::where('votes', '>', 100)->orWhere('name', 'John')->get();

// WHERE id IN (1, 2, 3)
$users = User::whereIn('id', [1, 2, 3])->get();

// Проверка по дате
$users = User::whereDate('created_at', '2016-12-31')->get();

Зачем?

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

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

Самостоятельная работа

  1. Откройте REPL. Попробуйте повыбирать пользователей по разным условиям.

Дополнительные материалы

  1. Язык запросов

Аватары экспертов Хекслета

Остались вопросы? Задайте их в разделе «Обсуждение»

Вам ответят команда поддержки Хекслета или другие студенты.

Ошибки, сложный материал, вопросы >
Нашли опечатку или неточность?

Выделите текст, нажмите ctrl + enter и отправьте его нам. В течение нескольких дней мы исправим ошибку или улучшим формулировку.

Что-то не получается или материал кажется сложным?

Загляните в раздел «Обсуждение»:

  • задайте вопрос. Вы быстрее справитесь с трудностями и прокачаете навык постановки правильных вопросов, что пригодится и в учёбе, и в работе программистом;
  • расскажите о своих впечатлениях. Если курс слишком сложный, подробный отзыв поможет нам сделать его лучше;
  • изучите вопросы других учеников и ответы на них. Это база знаний, которой можно и нужно пользоваться.

Об обучении на Хекслете

Для полного доступа к курсу нужен базовый план

Базовый план откроет полный доступ ко всем курсам, упражнениям и урокам Хекслета, проектам и пожизненный доступ к теории пройденных уроков. Подписку можно отменить в любой момент.

Получить доступ
900
упражнений
2000+
часов теории
3200
тестов

Открыть доступ

Курсы программирования для новичков и опытных разработчиков. Начните обучение бесплатно.

  • 130 курсов, 2000+ часов теории
  • 900 практических заданий в браузере
  • 360 000 студентов
Даю согласие на обработку персональных данных, соглашаюсь с «Политикой конфиденциальности» и «Условиями оказания услуг»

Наши выпускники работают в компаниях:

Логотип компании Альфа Банк
Логотип компании Aviasales
Логотип компании Yandex
Логотип компании Tinkoff
Рекомендуемые программы

С нуля до разработчика. Возвращаем деньги, если не удалось найти работу.

Иконка программы PHP-разработчик
Профессия
Разработка веб-приложений на Laravel
25 мая 10 месяцев

Используйте Хекслет по максимуму!

  • Задавайте вопросы по уроку
  • Проверяйте знания в квизах
  • Проходите практику прямо в браузере
  • Отслеживайте свой прогресс

Зарегистрируйтесь или войдите в свой аккаунт

Даю согласие на обработку персональных данных, соглашаюсь с «Политикой конфиденциальности» и «Условиями оказания услуг»