Che cos'è il query builder e come si relaziona con Eloquent?

Question

Accepted Answer

Il **Query Builder** di Laravel è un'interfaccia fluente e concatenabile per costruire ed eseguire query su database senza scrivere SQL grezzo. **Eloquent è costruito sopra il Query Builder** — i modelli Eloquent lo utilizzano dietro le quinte, e le query Eloquent possono usare tutti i metodi del Query Builder.

## The Query Builder (database-level, via 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']);
```

Il Query Builder funziona direttamente con le tabelle (restituendo oggetti semplici, non modelli Eloquent). È concatenabile e **utilizza automaticamente il parameter binding** — prevenendo SQL injection.

## Eloquent usa gli stessi metodi fluenti

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

Quando concateni metodi su un modello Eloquent, stai usando il Query Builder sottostante — ma ricevi **modelli** (con relazioni, accessor e metodi) anziché oggetti semplici.

## Query avanzate (entrambi le supportano)

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

Entrambi supportano join, aggregati, subquery e condizioni complesse.

## Quando usare quale

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

## Perché è importante

Comprendere il Query Builder e la sua relazione con Eloquent è importante per lavorare efficacemente con i database in Laravel e per scegliere lo strumento giusto per ogni situazione.

L'insight chiave è che **Eloquent è costruito sul Query Builder** — quindi i metodi fluenti e concatenabili che usi sui modelli Eloquent (`where`, `orderBy`, `join`, ecc.) sono quelli del Query Builder, il che significa che imparare uno insegna entrambi.

Il Query Builder fornisce un modo pulito e sicuro dall'SQL injection (tramite parameter binding automatico) per costruire query senza scrivere SQL grezzo, e Eloquent aggiunge funzionalità di modello (relazioni, accessor, metodi) in cima.

Sapere **quando usare quale** è l'abilità pratica: **Eloquent** per la maggior parte della logica applicativa (ottieni oggetti modello ricchi con relazioni e comportamento), e il **Query Builder direttamente** (`DB::table`) per query leggere senza overhead di modello, complesse segnalazioni/aggregati, o quando non hai bisogno di modelli completi — che può essere più efficiente in certi casi.

Entrambi gestiscono in modo sicuro query complesse (join, aggregati, subquery) con la stessa API fluente.

Comprendere il Query Builder, come Eloquent si basa su di esso, il parameter binding sicuro condiviso (prevenzione SQL injection), e la scelta tra loro è una conoscenza importante per scrivere codice database efficiente e sicuro in Laravel, poiché l'accesso al database è centrale nella maggior parte delle applicazioni e scegliere il livello appropriato (Eloquent ricco di modelli vs Query Builder leggero) influisce sia sulla chiarezza che sulle prestazioni.