Co je Eloquent a jak používáte modely?

Question

Accepted Answer

**Eloquent** je ORM (Object-Relational Mapper) Laravel — používá vzor **Active Record**, kde každá tabulka databáze má odpovídající třídu **Model** a instance modelů představují řádky. Poskytuje elegantní a expresivní způsob, jak se dotazovat na databázi a manipulovat s ní bez psaní SQL.

## Definování 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 rozšiřuje `Model` a mapuje se na tabulku podle konvence pojmenování (`User` → `users`). Список `$fillable` řídí, která pole lze hromadně přiřazovat (bezpečnostní funkce).

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

Eloquent fluent, zřetězitelné rozhraní API čte téměř jako angličtina a generuje SQL pro vás — žádné raw query pro běžné operace.

## Dotazování s fluent buildrem

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

## Modely jsou víc než data

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

## Proč je to důležité

Eloquent je jádrem Laravel — je to způsob, jak aplikace interagují s databází, a jeho elegantní design Active Record je jednou z nejdůležitějších funkcí frameworku, takže jeho zvládnutí je nezbytné pro jakýkoli vývoj v Laravel.

Porozumění tomu, jak definovat modely (mapování na tabulky podle konvence), provádět operace CRUD a dotazovat se s fluent, zřetězitelným buildrem, je každodenní, základní znalost, protože přístup k datům je jádrem většiny aplikací.

Expresivní a čitelné rozhraní API Eloquent (`User::where(...)->orderBy(...)->get()`) vám umožňuje pracovat s databází v čistém PHP bez psaní SQL, což dramaticky zvyšuje produktivitu a čitelnost.

Modely jsou také více než jen kontejnery dat — definují **vztahy** (propojování související tabulek) a mohou mít **accessory/mutatory** (počítané atributy) a obchodní logiku, což z nich dělá bohaté objekty domény.

Znalost ochrany `$fillable` hromadného přiřazování (bezpečnostní úvaha) je také důležitá.

Protože Eloquent je způsob, jak aplikace Laravel čtou a zapisují svá data — a objevuje se prakticky v každé aplikaci Laravel — zvládnutí modelů a Eloquent query API je základní, nezbytný materiál, který podtrhuje efektivní vývoj Laravel.