Что такое конструктор запросов (Query Builder) и как он связан с Eloquent?

Question

Accepted Answer

**Query Builder** в Laravel — это текучий, цепляемый интерфейс для построения и выполнения запросов к базе данных без написания сырого SQL. **Eloquent построен поверх Query Builder** — модели Eloquent используют его под капотом, а запросы Eloquent могут использовать все методы Query Builder.

## Конструктор запросов (уровень БД, через фасад DB)

```php
use Illuminate\Support\Facades\DB;

DB::table('users')
    ->where('active', true)
    ->where('age', '>', 18)
    ->orderBy('name')
    ->limit(10)
    ->get();                          // returns generic objects (not models)

DB::table('users')->where('id', 1)->update(['name' => 'X']);
DB::table('users')->insert(['name' => 'Ann']);
```

Query Builder работает непосредственно с таблицами (возвращая простые объекты, не модели Eloquent). Он цепляем и **автоматически использует привязку параметров** — предотвращая SQL-инъекции.

## Eloquent использует те же текучие методы

```php
// Eloquent queries support ALL Query Builder methods (it's built on top)
User::where('active', true)
    ->where('age', '>', 18)
    ->orderBy('name')
    ->get();                          // returns User MODELS (with relationships, etc.)
```

Когда вы вызываете методы по цепочке на модели Eloquent, вы используете Query Builder под капотом — но получаете обратно **модели** (с отношениями, аксессорами и методами) вместо простых объектов.

## Продвинутые запросы (оба поддерживают)

```php
DB::table('orders')
    ->join('users', 'orders.user_id', '=', 'users.id')   // joins
    ->select('orders.*', 'users.name')
    ->where('orders.total', '>', 100)
    ->groupBy('users.id')
    ->havingRaw('SUM(orders.total) > 1000')
    ->get();

User::where('role', 'admin')
    ->orWhere('role', 'editor')
    ->whereIn('status', ['active', 'pending'])
    ->get();
```

Оба поддерживают соединения, агрегаты, подзапросы и сложные условия.

## Когда использовать какой

```text
Eloquent (Model::...) → the default — get models with relationships/accessors/methods.
                        Best for most application logic.
Query Builder (DB::table) → when you want lightweight queries without model overhead,
                            complex reporting/aggregations, or to avoid loading models.
```

## Почему это важно

Понимание Query Builder и его связи с Eloquent важно для эффективной работы с базами данных в Laravel и выбора правильного инструмента для каждой ситуации.

Ключевой момент в том, что **Eloquent построен на Query Builder** — поэтому текучие, цепляемые методы, которые вы используете на моделях Eloquent (`where`, `orderBy`, `join` и т. д.), — это методы Query Builder, что означает, что изучение одного учит вас обоим.

Query Builder обеспечивает чистый, безопасный от SQL-инъекций (благодаря автоматической привязке параметров) способ построения запросов без написания сырого SQL, а Eloquent добавляет функциональность моделей (отношения, аксессоры, методы) сверху.

Знание **когда использовать какой** — это практический навык: **Eloquent** для большинства логики приложения (вы получаете богатые объекты моделей с отношениями и поведением), и **Query Builder напрямую** (`DB::table`) для легких запросов без накладных расходов модели, сложных отчетов/агрегаций или когда вам не нужны полные модели — что может быть более эффективным в определенных случаях.

Оба безопасно обрабатывают сложные запросы (соединения, агрегаты, подзапросы) с одним и тем же текучим API.

Понимание Query Builder, того, как Eloquent строится на его основе, общей безопасной привязки параметров (предотвращение SQL-инъекций) и выбора между ними — важное знание для написания эффективного и безопасного кода доступа к БД в Laravel, поскольку доступ к БД — центральная часть большинства приложений, а выбор соответствующего уровня (модель-ориентированный Eloquent или облегченный Query Builder) влияет как на ясность, так и на производительность.