Ce este query builder-ul și cum se raportează la Eloquent?

Question

Accepted Answer

**Query Builder** din Laravel este o interfață fluență și înlănțuibilă pentru construirea și executarea interogărilor bazei de date fără a scrie SQL brut. **Eloquent este construit pe baza Query Builder** — modelele Eloquent o folosesc în spate, iar interogările Eloquent pot folosi toate metodele Query Builder.

## Query Builder (nivel bază de date, prin fațada 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 funcționează direct cu tabelele (returnând obiecte simple, nu modele Eloquent). Este înlănțuibil și **folosește automat legarea parametrilor** — prevenind injecția SQL.

## Eloquent folosește aceleași metode fluente

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

Când înlănțuiți metode pe un model Eloquent, utilizați Query Builder-ul din spate — dar obțineți înapoi **modele** (cu relații, accessori și metode) în loc de obiecte simple.

## Interogări avansate (ambele le suportă)

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

Ambele suportă join-uri, agregate, subinterogări și condiții complexe.

## Când să folosiți fiecare

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

## De ce contează

Înțelegerea Query Builder-ului și a relației sale cu Eloquent este importantă pentru a lucra efectiv cu bazele de date în Laravel și pentru a alege instrumentul potrivit pentru fiecare situație.

Insight-ul cheie este că **Eloquent este construit pe Query Builder** — deci metodele fluente și înlănțuibile pe care le utilizați pe modelele Eloquent (`where`, `orderBy`, `join`, etc.) sunt ale Query Builder-ului, ceea ce înseamnă că învățarea unuia vă învață pe amândoi.

Query Builder oferă o modalitate curată și sigură împotriva injecției SQL (prin legarea automată a parametrilor) de a construi interogări fără a scrie SQL brut, iar Eloquent suprapune funcționalitatea modelului (relații, accessori, metode) deasupra.

Știind **când să folosiți fiecare** este abilitatea practică: **Eloquent** pentru majoritatea logicii aplicației (obțineți obiecte model bogate cu relații și comportament), și **Query Builder direct** (`DB::table`) pentru interogări ușoare fără suprasarcina modelului, rapoarte/agregate complexe, sau când nu aveți nevoie de modele complete — care poate fi mai eficient în anumite cazuri.

Ambele gestionează în siguranță interogări complexe (join-uri, agregate, subinterogări) cu aceeași API fluență.

Înțelegerea Query Builder-ului, a modului în care Eloquent se construiește pe el, a legării sigure a parametrilor comună (prevenind injecția SQL) și alegerea între ei este o cunoaștere importantă pentru a scrie cod de bază de date eficient și sigur în Laravel, deoarece accesul la baza de date este central pentru majoritatea aplicațiilor și alegerea nivelului corespunzător (Eloquent bogat în modele vs Query Builder ușor) afectează atât claritatea cât și performanța.