Kas yra užklausų kūrėjas ir kaip jis susietas su Eloquent?

Question

Accepted Answer

Laravel **Query Builder** yra sklandus, sujungiamas sąsajas, skirtas kurti ir vykdyti duomenų bazės užklausas be rankinio SQL rašymo. **Eloquent pastatytas ant Query Builder pagrindo** — Eloquent modeliai jį naudoja iš vidaus, ir Eloquent užklausas gali naudoti visus Query Builder metodus.

## Query Builder (duomenų bazės lygis, per DB facade)

```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 tiesiogiai dirba su lentelėmis (grąžina paprastus objektus, ne Eloquent modelius). Jis yra sujungiamas ir **automatiškai naudoja parametrų susiejimą** — užkirsdamas kelią SQL injekcijoms.

## Eloquent naudoja tuos pačius sklandžius metodus

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

Kai jungiate metodus Eloquent modelyje, po apačia naudojate Query Builder — tačiau gaunate **modelius** (su santykiais, prieigomis ir metodais), o ne paprastus objektus.

## Sudėtingos užklausas (abu palaikomi šie)

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

Abu palaikomi sujungimai, suvestinės, poskyrės ir sudėtingos sąlygos.

## Kada kuritą naudoti

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

## Kodėl tai svarbu

Supratimas apie Query Builder ir jo ryšį su Eloquent yra svarbus efektyviai dirbant su duomenų bazėmis Laravel ir pasirenkant tinkamą įrankį kiekvienai situacijai.

Pagrindinė nuomonė yra, kad **Eloquent pastatytas ant Query Builder pagrindo** — todėl sklandūs, sujungiami metodai, kuriuos naudojate Eloquent modeliuose (`where`, `orderBy`, `join` ir kt.), yra Query Builder metodai, todėl vieno išmokimas moko abiejų.

Query Builder suteikia švarų, apsaugotą nuo SQL injekcijų (per automatinį parametrų susiejimą) būdą kurti užklausas be rankinio SQL rašymo, o Eloquent virš to sudeda modelio funkcionalumą (santykius, prieigomis, metodus).

Žinojimas **kada kuritą naudoti** yra praktinis įgūdis: **Eloquent** daugumai programos logikos (gaunate turtingus modelio objektus su santykiais ir elgesiu), ir **Query Builder tiesiogiai** (`DB::table`) lengviems užklausom be modelio pridėjimo, sudėtingoms ataskaitoms/suvestinėms arba kai jums nereikia pilnų modelių — tai gali būti efektyviau tam tikriems atvejams.

Abu saugiai tvarko sudėtingas užklausas (sujungimus, suvestines, poskyrės) tuo pačiu sklandžiu API.

Supratimas apie Query Builder, kaip Eloquent jį plečia, bendrą saugų parametrų susiejimą (užkirsdamas kelią SQL injekcijoms) ir pasirinkimą tarp jų yra svarbi žinios, skirtos rašyti efektyvų, saugų duomenų bazės kodą Laravel, nes duomenų bazės prieiga yra pagrindinė daugumoje programų ir pasirinkus atitinkamą lygį (modeliu turtas Eloquent ar lengvas Query Builder) veikia tiek aiškumą, tiek našumą.