Publikováno
· Autor: Zdeněk Hejzlar · Pod kapotou · Základy · 3 min čtení
Obsah článku
Máte v databázi uživatele, jejich objednávky a produkty — a pořád dokola píšete ruční JOINy, ve kterých se ztrácíte? Přesně tohle za vás v Laravelu řeší Eloquent vztahy. V tomhle článku projdeme tři nejčastější typy, které pokryjí většinu reálných situací.
Vztah jeden k mnoha
Nejběžnější případ: jeden autor má mnoho článků. Na modelu autora popíšete hasMany, na modelu článku opačný směr belongsTo:
class Autor extends Model
{
public function clanky(): \Illuminate\Database\Eloquent\Relations\HasMany
{
return $this->hasMany(Clanek::class);
}
}
class Clanek extends Model
{
public function autor(): \Illuminate\Database\Eloquent\Relations\BelongsTo
{
return $this->belongsTo(Autor::class);
}
}
Podmínkou je sloupec autor_id v tabulce článků — takzvaný cizí klíč, který říká, kterému autorovi článek patří. Návratové typy u metod doporučuju vždy uvádět; podle nich hned poznáte, o jaký vztah jde, a napovídá vám i editor. Pak k datům přistupujete jako k vlastnosti objektu — čistě a čitelně:
$autor = Autor::find(1);
foreach ($autor->clanky as $clanek) {
echo $clanek->nazev;
}
Vztah mnoho k mnoha
Produkt může mít víc kategorií a kategorie víc produktů. Tady potřebujete spojovací tabulku (např. category_product) a na obou modelech metodu belongsToMany:
public function kategorie(): \Illuminate\Database\Eloquent\Relations\BelongsToMany
{
return $this->belongsToMany(Kategorie::class);
}
Přiřazení a odebrání pak zvládnete jedním voláním:
$produkt->kategorie()->attach($kategorieId);
$produkt->kategorie()->detach($kategorieId);
$produkt->kategorie()->sync([1, 2, 3]);
attachpřidá vazbu,detachji odebere.syncnastaví přesně daný seznam — cokoli navíc smaže.- Do spojovací tabulky lze uložit i doplňková data přes
withPivot.
Právě spojovací tabulka bývá pro začátečníky nejméně zřejmá. Nemá vlastní model ani stránku — je to jen prostředník, který drží dvojice ID. Zato je mimořádně užitečná: díky ní přiřadíte produkt do libovolného počtu kategorií, aniž byste kdekoli měnili strukturu tabulek.
Pozor na pomalé dotazy
Nejčastější past začátečníka: v cyklu procházíte autory a u každého saháte na jeho články. To spustí jeden dotaz navíc pro každý řádek — klasická past na výkon. Řešení je jednořádkové, jmenuje se eager loading a spočívá ve volání Autor::with('clanky')->get().
Místo desítek dotazů se provedou jen dva. U větších tabulek to je rozdíl mezi svižnou a viditelně sekající stránkou. Doporučuju při vývoji sledovat počet dotazů — když jich najednou přibývá lineárně s počtem řádků, skoro jistě vám chybí with(). Předehrát se dá i opačně: přes load() dotáhnete vztah k objektu, který už v paměti máte. A když vás zajímá jen počet souvisejících záznamů, ne jejich obsah, sáhněte po withCount() — vrátí číslo jediným dotazem, aniž by tahal celé řádky. Tyhle tři metody pokryjí drtivou většinu situací, kde se řeší rychlost načítání vztahů.
Buďme féroví: u tří záznamů tenhle problém nikdo nepozná. Řešte ho tam, kde jde o výpisy s desítkami až stovkami položek; širší pohled na zrychlování webu dávám v článku optimalizace výkonu Laravel aplikace.
Kdy sáhnout jinam
Eloquent je pohodlný, ale u opravdu složitých sestav nad miliony řádků se občas vyplatí napsat ruční dotaz přes query builder. Není to prohra — je to volba správného nástroje. Pro naprostou většinu backendu ale vztahy stačí a ušetří vám hodiny.
Než začnete vztahy psát, měli byste mít připravené tabulky — bez promyšleného návrhu schématu se dobrý datový model postavit nedá. Dobře navržené vztahy jsou základ, na kterém pak stojí čitelný a svižný kód celé aplikace, tak jim věnujte čas hned na začátku.
Řešíte model dat pro konkrétní projekt a nejste si jistí návrhem vztahů? Napište mi, nezávazně to spolu probereme.