Eloquent ORM: Modely, metoda casts(), relace HasMany a BelongsTo

Eloquent ORM: Síla objektově-relačního mapování v Laravelu 12

Eloquent ORM je srdcem databázové vrstvy Laravelu. Implementuje návrhový vzor Active Record, kde každá PHP třída modelu reprezentuje jednu tabulku a instance modelu odpovídá konkrétnímu řádku v této tabulce.

V moderním Laravelu 12 a PHP 8.4 píšeme modely se striktním typováním a maximálním využitím nativního typového systému.

1. Nová metoda casts(): array v Laravelu 12

Historicky se v Eloquent modelech přetypování sloupců definovalo přes chráněnou vlastnost protected $casts = [...]. Od Laravelu 11 a 12 je standardem deklarovat metodu protected function casts(): array:

// app/Models/CourseModule.php
protected function casts(): array
{
    return [
        'difficulty' => ModuleDifficulty::class,
        'number' => 'integer',
        'estimated_minutes' => 'integer',
    ];
}

Proč je metoda lepší než vlastnost?

1. Nativní podpora enumů: Můžeme přímo uvést FQCN enumu ModuleDifficulty::class.
2. Dynamická logika a dědičnost: V případě potřeby můžete v metodě volat pomocné funkce nebo slučovat pravidla z rodičovské třídy (array_merge(parent::casts(), [...])).
3. Statická analýza: Nástroje jako PHPStan / Larastan mnohem lépe analyzují návratový typ metody a kontrolují správnost typů.

2. Automatické přetypování na PHP 8.4 Backed Enumy

Všimněte si přetypování 'difficulty' => ModuleDifficulty::class:

• V PostgreSQL je v sloupci difficulty uložen obyčejný řetězec 'beginner'.
• Jakmile v kódu přistoupíte k $module->difficulty, Eloquent hodnotu automaticky převede na instanci enumu ModuleDifficulty::Beginner.
• Můžete rovnou volat metody enumu: $module->difficulty->label() nebo $module->difficulty->badgeClass().
• Při uložení do databáze ($module->save()) Eloquent automaticky extrahuje surovou hodnotu $enum->value.

V modelu CourseLesson stejným způsobem přetypováváme sloupec lifecycle_phase na LifecyclePhase::class a sloupec anatomy_files na 'array' (automatický JSON decode/encode).

3. Vztahy HasMany a BelongsTo

Eloquent umožňuje definovat čisté obousměrné relace:

V modelu CourseModule:

/**
 * @return HasMany<CourseLesson, $this>
 */
public function lessons(): HasMany
{
    return $this->hasMany(CourseLesson::class)->orderBy('number');
}

V modelu CourseLesson:

/**
 * @return BelongsTo<CourseModule, $this>
 */
public function module(): BelongsTo
{
    return $this->belongsTo(CourseModule::class, 'course_module_id');
}

/**
 * @return HasMany<QuizQuestion, $this>
 */
public function quizQuestions(): HasMany
{
    return $this->hasMany(QuizQuestion::class)->orderBy('position');
}

Všimněte si klíčového rozdílu:

• $module->lessons() (s kulatými závorkami) vrací instanci Query Builderu relace HasMany. Můžete nad ní dále řetězit podmínky, např. $module->lessons()->where('lifecycle_phase', 'view')->get().
• $module->lessons (bez závorek, dynamická vlastnost) dotaz rovnou provede a vrátí instanci Illuminate\Database\Eloquent\Collection obsahující načtené modely.