Vai al contenuto principale

​
Cos’è Eloquent ORM

Laravel include Eloquent, un Object Relational Mapper (ORM). Eloquent semplifica l’interazione con il database e implementa il pattern ActiveRecord. Con Eloquent prepari una classe “modello” corrispondente a ciascuna tabella del database. Tramite il modello puoi recuperare, inserire, aggiornare ed eliminare i record.
Prima di usare Eloquent, configura la connessione al database in config/database.php. Per impostazione predefinita vengono usate le impostazioni DB_* del file .env.

​
Creazione di un modello

Con il comando Artisan make:model generi un nuovo modello. 
php artisan make:model Post
Per crearlo insieme alla migration usa l’opzione -m. 
php artisan make:model Post -m
I modelli vengono creati nella directory app/Models. 
<?php

namespace App\Models;

use Illuminate\Database\Eloquent\Model;

class Post extends Model
{
    // ...
}

​
Corrispondenza tra modello e tabella

Eloquent deduce automaticamente il nome della tabella dal nome della classe. Il nome della tabella è la forma plurale in snake_case del nome della classe.
Nome del modelloNome della tabella
Postposts
Userusers
AirTrafficControllerair_traffic_controllers
Se il nome della tabella non segue la convenzione, indicalo esplicitamente con la proprietà $table. 
class Post extends Model
{
    protected $table = 'blog_posts';
}

​
Timestamp

Eloquent gestisce automaticamente le colonne created_at e updated_at di default. Se nella migration aggiungi $table->timestamps(), i valori vengono impostati automaticamente al salvataggio e all’aggiornamento. Per disabilitare la gestione automatica imposta $timestamps a false. 
class Post extends Model
{
    public $timestamps = false;
}

​
Protezione da mass assignment

Quando salvi dati in blocco con Eloquent è necessaria la configurazione della protezione da mass assignment.

​
fillable

Con la proprietà $fillable indichi le colonne che accettano assegnazione. 
class Post extends Model
{
    protected $fillable = [
        'user_id',
        'title',
        'body',
        'published',
    ];
}

​
guarded

Per indicare le colonne da vietare all’assegnazione usa $guarded. 
class Post extends Model
{
    // Protegge solo la chiave primaria, consente tutto il resto
    protected $guarded = ['id'];
}
Con $guarded come array vuoto consenti l’assegnazione a tutte le colonne. Se passi direttamente input utente, c’è il rischio che colonne non previste vengano sovrascritte, quindi è consigliato indicare esplicitamente le colonne consentite con $fillable.

​
Flusso di esecuzione delle query Eloquent

Ecco come una query come User::where()->get() viene eseguita internamente.

​
Operazioni CRUD di base

​
Recuperare record (Read)

Recupera tutti i record. 
use App\Models\Post;

$posts = Post::all();
Recupera con condizioni. 
// Recupera i post con published a true
$publishedPosts = Post::where('published', true)->get();

// Recupera il primo
$post = Post::where('published', true)->first();

// Recupera per ID
$post = Post::find(1);

// Restituisce 404 se non trovato
$post = Post::findOrFail(1);

​
Creare record (Create)

Con il metodo create inserisci un record (serve la configurazione di $fillable). 
$post = Post::create([
    'title' => 'Il mio primo post',
    'body' => 'Laravel è un framework fantastico.',
    'published' => true,
]);
Puoi anche creare l’istanza e assegnare i valori singolarmente. 
$post = new Post;
$post->title = 'Il mio primo post';
$post->body = 'Laravel è un framework fantastico.';
$post->save();

​
Aggiornare record (Update)

Recupera un modello, modifica i valori e chiama save per aggiornare. 
$post = Post::find(1);
$post->title = 'Titolo aggiornato';
$post->save();
Con il metodo update aggiorni più colonne insieme. 
Post::find(1)->update([
    'title' => 'Titolo aggiornato',
    'published' => true,
]);
Puoi anche aggiornare in blocco più record che soddisfano una condizione. 
Post::where('published', false)->update(['published' => true]);

​
Eliminare record (Delete)

Con il metodo delete elimini un record. 
$post = Post::find(1);
$post->delete();
Puoi eliminare direttamente specificando l’ID. 
Post::destroy(1);

// Elimina più ID insieme
Post::destroy([1, 2, 3]);

​
Metodi di query di base

MetodoDescrizione
Post::all()Recupera tutti i record
Post::find($id)Recupera per ID (restituisce null se non trovato)
Post::findOrFail($id)Recupera per ID (restituisce 404 se non trovato)
Post::where('column', 'value')->get()Recupera i record che soddisfano la condizione
Post::where('column', 'value')->first()Recupera il primo record che soddisfa la condizione
Post::where('column', 'value')->count()Conta i record che soddisfano la condizione
Post::orderBy('created_at', 'desc')->get()Recupera specificando l’ordinamento
Post::latest()->get()Recupera in ordine decrescente per created_at
Post::limit(10)->get()Recupera limitando il numero

​
Esempio pratico: manipolazione dei dati con il modello Post

Esempio di controller che manipola la tabella posts creata con la migration. 
<?php

namespace App\Http\Controllers;

use App\Models\Post;
use Illuminate\Http\RedirectResponse;
use Illuminate\Http\Request;
use Illuminate\View\View;

class PostController extends Controller
{
    // Mostra l'elenco dei post
    public function index(): View
    {
        $posts = Post::where('published', true)
            ->latest()
            ->get();

        return view('posts.index', ['posts' => $posts]);
    }

    // Crea un post
    public function store(Request $request): RedirectResponse
    {
        $validated = $request->validate([
            'title' => ['required', 'string', 'max:255'],
            'body' => ['required', 'string'],
            'published' => ['boolean'],
        ]);

        Post::create([
            ...$validated,
            'user_id' => $request->user()->id,
        ]);

        return redirect('/posts');
    }

    // Aggiorna un post
    public function update(Request $request, Post $post): RedirectResponse
    {
        $validated = $request->validate([
            'title' => ['required', 'string', 'max:255'],
            'body' => ['required', 'string'],
        ]);

        $post->update($validated);

        return redirect('/posts');
    }

    // Elimina un post
    public function destroy(Post $post): RedirectResponse
    {
        $post->delete();

        return redirect('/posts');
    }
}
Scrivendo Post $post come argomento del metodo del controller, Laravel recupera automaticamente il modello dai parametri di route (route model binding). Non devi più scrivere manualmente Post::findOrFail($id).

​
Ciclo di vita degli eventi del modello

Flusso degli eventi emessi quando chiami save(). Gli eventi cambiano in base al fatto che sia una creazione o un aggiornamento, ma saving e saved vengono emessi in entrambi i casi.

​
Prossimi passi

Migration

Rivedi come creare con le migration le tabelle usate da Eloquent.
Ultima modifica il 13 luglio 2026

Argomenti correlati

Introduzione alle relazioni EloquentCollezioni EloquentSerializzazione EloquentIntroduzione all'autenticazioneEloquent Factory