Mi a query builder, és hogyan kapcsolódik az Eloquent-hez?

Question

Accepted Answer

A Laravel **Query Builder** egy fluent, láncható interfész az adatbázis-lekérdezések felépítéséhez és futtatásához anélkül, hogy nyers SQL-t kellene írni. **Az Eloquent a Query Builder-re épül** — az Eloquent modellek a háttérben használják, és az Eloquent lekérdezések minden Query Builder metódust tudnak használni.

## A Query Builder (adatbázis szintű, a DB facade-on keresztül)

```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']);
```

A Query Builder közvetlenül táblákkal működik (sima objektumokat ad vissza, nem Eloquent modelleket). Láncható és **automatikusan paraméter kötést használ** — megelőzve az SQL injektálást.

## Az Eloquent ugyanazokat a fluent metódusokat használja

```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.)
```

Ha egy Eloquent modellen láncolsz metódusokat, a Query Builder-t használod a háttérben — de **modelleket** kapsz vissza (kapcsolatokkal, accesorokkal és metódusokkal) sima objektumok helyett.

## Fejlett lekérdezések (mindkettő támogatja ezeket)

```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();
```

Mindkettő támogatja az join-okat, aggregátumokat, allekérdezéseket és összetett feltételeket.

## Mikor melyiket használd

```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.
```

## Miért számít

A Query Builder és az Eloquent kapcsolatának megértése fontos a Laravel adatbázisaival való hatékony munkához és a megfelelő eszköz kiválasztásához az egyes helyzetekre.

A legfontosabb felismerés, hogy **az Eloquent a Query Builder-re épül** — így a fluent, láncható metódusok, amelyeket az Eloquent modelleken használsz (`where`, `orderBy`, `join`, stb.), a Query Builder-é, ami azt jelenti, hogy az egyik tanulmányozása mindkettőt megtanítja neked.

A Query Builder egy tiszta, SQL injektálásra biztos módot biztosít (automatikus paraméter kötésen keresztül) lekérdezések felépítésére anélkül, hogy nyers SQL-t kellene írni, és az Eloquent modell funkcionalitást (kapcsolatokat, accesorokat, metódusokat) helyez rá.

A **megfelelő eszköz kiválasztása gyakorlati készség**: **Eloquent** a legtöbb alkalmazás logikához (gazdag modell objektumokat kapsz kapcsolatokkal és viselkedéssel), és a **Query Builder közvetlenül** (`DB::table`) a könnyű lekérdezésekhez modell terhelés nélkül, összetett jelentésekhez/aggregátumokhoz, vagy amikor nem kell teljes modellek — ami bizonyos esetekben hatékonyabb lehet.

Mindkettő biztonságosan kezeli az összetett lekérdezéseket (join-okat, aggregátumokat, allekérdezéseket) ugyanazzal a fluent API-val.

A Query Builder megértése, hogyan épül rá az Eloquent, az osztott biztonságos paraméter kötés (SQL injektálás megelőzése), és a választás közöttük fontos tudás a hatékony, biztonságos adatbázis kódok írásához a Laravel-ben, mivel az adatbázis elérés a legtöbb alkalmazás központi része, és a megfelelő szint kiválasztása (modellekben gazdag Eloquent vs könnyű Query Builder) hat mind az átláthatóságra, mind a teljesítményre.