Che cos'è Eloquent e come si utilizzano i modelli?

Question

Accepted Answer

**Eloquent** è l'ORM (Object-Relational Mapper) di Laravel — utilizza il pattern **Active Record**, dove ogni tabella del database ha una classe **Model** corrispondente, e le istanze del modello rappresentano righe. Fornisce un modo elegante ed espressivo per interrogare e manipolare il database senza scrivere SQL.

## Definire un modello

```php
<?php
class User extends Model {
    // by convention, the User model maps to the "users" table automatically
    protected $fillable = ['name', 'email'];   // mass-assignable fields (security)
}
// generate with: php artisan make:model User
```

Un modello estende `Model` e si mappa a una tabella per convenzione di naming (`User` → `users`). La lista `$fillable` controlla quali campi possono essere mass-assigned (una caratteristica di sicurezza).

## Operazioni CRUD (Active Record)

```php
// CREATE
$user = User::create(['name' => 'Ann', 'email' => 'ann@x.com']);
$user = new User; $user->name = 'Bob'; $user->save();

// READ
User::all();                              // all rows
User::find(1);                            // by primary key
User::where('active', true)->get();        // query with conditions
User::where('email', $email)->first();     // first match

// UPDATE
$user->update(['name' => 'New Name']);
$user->name = 'X'; $user->save();

// DELETE
$user->delete();
User::destroy(1);
```

L'API fluent e concatenabile di Eloquent si legge quasi come l'inglese e genera l'SQL per te — nessuna query raw per le operazioni comuni.

## Interrogazione con il fluent builder

```php
User::where('age', '>', 18)
    ->where('active', true)
    ->orderBy('name')
    ->limit(10)
    ->get();                              // chainable query building

User::where('role', 'admin')->count();
User::where('email', $e)->exists();
```

## I modelli sono più dei dati

```php
class Post extends Model {
    public function author() {                          // a relationship
        return $this->belongsTo(User::class);
    }
    public function getExcerptAttribute() {              // an accessor (computed attribute)
        return Str::limit($this->body, 100);
    }
}
$post->author;       // the related User
$post->excerpt;       // computed attribute
```

## Perché è importante

Eloquent è centrale in Laravel — è il modo in cui le applicazioni interagiscono con il database, e il suo elegante design Active Record è una delle caratteristiche più celebrate del framework, quindi padroneggiarlo è essenziale per ogni sviluppo Laravel.

Capire come definire i modelli (mappare alle tabelle per convenzione), eseguire operazioni CRUD e interrogare con il builder fluent e concatenabile è una conoscenza quotidiana e fondamentale poiché l'accesso ai dati è al centro della maggior parte delle applicazioni.

L'API espressiva e leggibile di Eloquent (`User::where(...)->orderBy(...)->get()`) ti consente di lavorare con il database in PHP pulito senza scrivere SQL, migliorando drammaticamente la produttività e la leggibilità.

I modelli sono anche più che semplici contenitori di dati — definiscono **relazioni** (collegando tabelle correlate) e possono avere **accessor/mutator** (attributi calcolati) e logica di business, rendendoli oggetti di dominio ricchi.

Conoscere la protezione mass-assignment di `$fillable` (una considerazione di sicurezza) è altresì importante.

Poiché Eloquent è il modo in cui le applicazioni Laravel leggono e scrivono i loro dati — e appare praticamente in ogni app Laravel — padroneggiare i modelli e l'API di query di Eloquent è materiale fondamentale che è essenziale conoscere e che supporta uno sviluppo Laravel efficace.