Ce este Eloquent și cum se folosesc modelele?

Question

Accepted Answer

**Eloquent** este ORM-ul (Object-Relational Mapper) Laravel — folosește modelul **Active Record**, unde fiecare tabel din baza de date are o clasă **Model** corespunzătoare, iar instanțele modelului reprezintă rânduri. Oferă o modalitate elegantă și expresivă de a interoga și manipula baza de date fără a scrie SQL.

## Definirea unui model

```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 model extinde `Model` și se mapează la un tabel prin convenție de denumire (`User` → `users`). Lista `$fillable` controlează care câmpuri pot fi atribuite în masă (o caracteristică de securitate).

## Operații 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);
```

API-ul fluent și înlănțuibil al Eloquent citește aproape ca English și generează SQL-ul pentru tine — fără query-uri brute pentru operații comune.

## Interogări cu builder-ul fluent

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

## Modelele sunt mai mult decât date

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

## De ce conteaza

Eloquent este central în Laravel — acesta este modul în care aplicațiile interacționează cu baza de date, iar designul elegant Active Record este una dintre caracteristicile cele mai apreciate ale framework-ului, deci stăpânirea acestuia este esențială pentru orice dezvoltare Laravel.

Înțelegerea modului de definire a modelelor (maparea la tabele prin convenție), efectuarea operațiilor CRUD și interogarea cu builder-ul fluent, înlănțuibil este cunoaștere fundamentală și cotidiană, deoarece accesul la date este esențial pentru majoritatea aplicațiilor.

API-ul expresiv și ușor de citit al Eloquent (`User::where(...)->orderBy(...)->get()`) te permite să lucrezi cu baza de date în PHP curat fără a scrie SQL, îmbunătățind drastic productivitatea și lizibilitatea.

Modelele sunt, de asemenea, mai mult decât containere de date — ele definesc **relații** (conectând tabele corelate) și pot avea **accessori/mutatori** (atribute calculate) și logică de business, făcând-le obiecte bogate de domeniu.

Cunoașterea protecției atribuirii în masă `$fillable` (o considerație de securitate) este, de asemenea, importantă.

Deoarece Eloquent este modul în care aplicațiile Laravel citesc și scriu datele lor — și apare în practică în fiecare aplicație Laravel — stăpânirea modelelor și API-ului de interogare Eloquent este material fundamental și must-know care stă la baza dezvoltării eficiente Laravel.