Kaj je Query Builder in kako se nanaša na Eloquent?

Question

Accepted Answer

Laravel's **Query Builder** je fluenten, verižni vmesnik za gradnjo in izvajanje podatkovnih poizvedb brez pisanja surove SQL. **Eloquent je zgrajen na vrhu Query Builderja** — modeli Eloquent ga uporabljajo pod pokrovom, in Eloquent poizvedbe lahko uporabljajo vse metode Query Builderja.

## Query Builder (nivo podatkovne zbirke, prek DB fasade)

```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 deluje direktno s tabelami (vrača navadne objekte, ne modelov Eloquent). Je verižljiv in **samodejno uporablja vezavo parametrov** — preprečuje SQL injection.

## Eloquent uporablja iste fluent metode

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

Ko verižite metode na modelu Eloquent, uporabljate Query Builder pod pokrovom — vendar dobite nazaj **modele** (s povezavami, akcesorji in metodami) namesto navadnih objektov.

## Napredne poizvedbe (oboje to podpira)

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

Oboje podpira spajanja, agregate, podpoizvedbe in zapletene pogoje.

## Kdaj uporabiti kaj

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

## Zakaj je to pomembno

Razumevanje Query Builderja in njegovega razmerja do Eloquenta je pomembno za učinkovito delo s podatkovnimi zbirkami v Laravelu in za izbiro pravega orodja za vsako situacijo.

Klučni vpogled je, da je **Eloquent zgrajen na Query Builderju** — zato so fluent, verižne metode, ki jih uporabljate na modelih Eloquent (`where`, `orderBy`, `join` itd.), Query Builderjeve, kar pomeni, da učenje enega nauči oba.

Query Builder zagotavlja čist, varoren pred SQL injection (prek samodejne vezave parametrov) način gradnje poizvedb brez pisanja surove SQL, Eloquent pa sloji funkcionalnost modelov (povezave, akcesorji, metode) na vrh.

Znanje o **kdaj uporabiti kaj** je praktična spretnost: **Eloquent** za večino logike aplikacije (dobite bogate modelne objekte s povezavami in obnašanjem), in **Query Builder direktno** (`DB::table`) za lahke poizvedbe brez režije modelov, kompleksne poročane/agregate, ali kadar ne potrebujete polnih modelov — kar je lahko bolj učinkovito v nekaterih primerih.

Oboje varno obdeluje kompleksne poizvedbe (spajanja, agregate, podpoizvedbe) z istim fluent API-jem.

Razumevanje Query Builderja, kako ga Eloquent gradi nanj, skupne varne vezave parametrov (preprečevanje SQL injection) in izbiro med njima je pomembno znanje za pisanje učinkovitega, varnega koda za dostop do podatkov v Laravelu, ker je dostop do podatkov osrednjega pomena za večino aplikacij in izbira ustrezne ravni (bogat model Eloquent v primerjavi z lahkim Query Builderjem) vpliva tako na jasnost kot na zmogljivost.