Czym jest Eloquent i jak używać modeli?

Question

Accepted Answer

**Eloquent** to ORM (Object-Relational Mapper) Laravela — wykorzystuje wzorzec **Active Record**, gdzie każda tabela bazy danych ma odpowiadającą jej klasę **Model**, a instancje modelu reprezentują wiersze. Zapewnia elegancki, wyrazisty sposób na odpytywanie i manipulowanie bazą danych bez pisania SQL.

## Definiowanie modelu

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

Model rozszerza `Model` i mapuje się do tabeli na podstawie konwencji nazewnictwa (`User` → `users`). Lista `$fillable` kontroluje, które pola mogą być przypisane masowo (funkcja bezpieczeństwa).

## Operacje 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);
```

Fluent, łańcuchowy API Eloquenta czyta się prawie jak angielski i generuje SQL za ciebie — żadnych surowych zapytań dla typowych operacji.

## Odpytywanie za pomocą 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();
```

## Modele to coś więcej niż dane

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

## Dlaczego to ważne

Eloquent jest centralnym elementem Laravela — to sposób, w jaki aplikacje wchodzą w interakcję z bazą danych, a jego elegancki design Active Record to jedna z najbardzej chwalonych cech frameworka, dlatego opanowanie go jest niezbędne dla każdego developera pracującego z Laravelem.

Zrozumienie, jak definiować modele (mapowanie do tabel na podstawie konwencji), wykonywać operacje CRUD i odpytywać za pomocą fluent, łańcuchowego buildra to codziennie używana, fundamentalna wiedza, ponieważ dostęp do danych jest sednem większości aplikacji.

Expresyjne, czytelne API Eloquenta (`User::where(...)->orderBy(...)->get()`) pozwala na pracę z bazą danych w czystym PHP bez pisania SQL, dramatycznie zwiększając produktywność i czytelność kodu.

Modele to również coś więcej niż kontenery danych — definiują **relacje** (łączące powiązane tabele) i mogą mieć **akcesory/mutatory** (obliczone atrybuty) oraz logikę biznesową, co czyni je bogatymi obiektami domeny.

Znajomość ochrony `$fillable` przed przypisaniem masowym (kwestia bezpieczeństwa) jest również ważna.

Ponieważ Eloquent to sposób, w jaki aplikacje Laravelowe czytają i zapisują swoje dane — i pojawia się praktycznie w każdej aplikacji Laravelowej — opanowanie modeli i API zapytań Eloquenta to materiał fundamentalny, musi być znany, który stanowi podstawę efektywnego rozwoju z Laravelem.