Eloquent vztahy prakticky

Ukážu vám, jak v Eloquentu propojit tabulky přes hasMany, belongsTo i many-to-many — a jak se přitom vyhnout pomalým dotazům, které web zbytečně brzdí.
Publikováno 02.11.2026

Eloquent vztahy prakticky

Publikováno

· Autor: · 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]);
  • attach přidá vazbu, detach ji odebere.
  • sync nastaví 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.