Routování v routes/web.php, pojmenované routy a Route Model Binding

Úvod do routovací vrstvy Laravelu 12

Routovací vrstva (Routing) představuje vstupní bránu do aplikační logiky frameworku. Jakmile HTTP požadavek projde přes webserver (FrankenPHP) a bootstrap fázi (bootstrap/app.php), jádro frameworku předá objekt Illuminate\Http\Request routovací tabulce definované v routes/web.php.

Hlavním úkolem routeru je porovnat příchozí HTTP metodu (GET, POST, PUT, DELETE atd.) a URI cestu proti registrovaným vzorům a určit cílový handler (akci v Controlleru, Livewire komponentu nebo anonymní funkci Closure).

Příchozí HTTP požadavek (GET /moduly/routing-middleware-a-controllery)
        │
        ▼
   routes/web.php ──► Vyhodnocení trasy & HTTP metody
        │
        ▼
   Implicitní / Scoped Route Model Binding (vyhledání entity v PostgreSQL)
        │
        ▼
   Předání čisté instance CourseModule do CourseController::module()

1. Pojmenované routy (Named Routes) a generování URL

V profesionálním vývoji se nikdy neodkazujeme na cílové stránky „natvrdo vepsaným“ textem URL (např. <a href="/moduly/...">). Místo toho přiřazujeme trasám unikátní název pomocí metody ->name():

Route::get('/moduly/{module:slug}', [CourseController::class, 'module'])
    ->name('course.module');

V Blade šablonách nebo přesměrováních pak URL sestavujeme pomocí helper funkce route():

<a href="{{ route('course.module', $module) }}">
    {{ $module->title }}
</a>

Proč je tento přístup klíčový:

1. Refaktoring beze strachu: Změní-li se kdykoliv struktura URL (např. z /moduly/... na /kurz/kapitoly/...), stačí změnit jeden řádek v routes/web.php. Veškeré odkazy v šablonách i přesměrování v aplikaci zůstanou okamžitě plně funkční.
2. Automatická serializace parametrů: Předáte-li do helperu route('course.module', $module) přímo Eloquent model, Laravel z něj automaticky vytáhne klíč pro URL podle metody getRouteKeyName().

2. Route Model Binding: Od URL parametru k Eloquent entitě

Jednou z nejelegantnějších vlastností Laravelu je Route Model Binding. Místo ručního dotazování do databáze v controlleru necháme framework vyhledat model automaticky:

A) Implicitní vazba podle sloupce (Scoped / Custom Key)

Ve výchozím stavu Laravel hledá záznamy podle primárního klíče id. V moderních webových aplikacích však vyžadujeme SEO přívětivé URL se slugem:

// routes/web.php
Route::get('/moduly/{module:slug}', [CourseController::class, 'module'])
    ->name('course.module');

Syntaxe {module:slug} říká frameworku: „Vezmi hodnotu z URL, najdi v tabulce course_modules řádek, kde slug = :hodnota, a předej nalezenou instanci CourseModule do parametru metody controlleru.“ Pokud záznam neexistuje, router okamžitě vyhodí výjimku ModelNotFoundException, která vyústí v čistou HTTP chybu 404 Not Found.

B) Vnořený Scoped Route Model Binding

V naší aplikaci máme trasu pro zobrazení konkrétní lekce v modulu:

Route::get('/moduly/{module:slug}/lekce/{lesson:slug}', [CourseController::class, 'lesson'])
    ->name('course.lesson');

Zde nastupuje Scoped Binding: Laravel nejenže vyhledá $module a $lesson, ale díky Eloquent relaci mezi CourseModule a CourseLesson automaticky ověří, že daná lekce skutečně patří tomuto konkrétnímu modulu! Pokud by se útočník pokusil podvrhnout cizí slug lekce k jinému modulu, framework automaticky vrátí 404 Not Found.

3. Rozbor reálného kódu v naší aplikaci

Podívej se do našeho souboru routes/web.php. Zde jsou definovány veškeré veřejné trasy platformy:

• Route::get('/', [CourseController::class, 'index'])->name('course.index'); — Hlavní rozcestník.
• Route::get('/moduly/{module:slug}', [CourseController::class, 'module'])->name('course.module'); — Přehled modulu.
• Route::get('/moduly/{module:slug}/lekce/{lesson:slug}', [CourseController::class, 'lesson'])->name('course.lesson'); — Detail lekce s živou anatomií.
• Route::get('/api/status', ...)->name('api.status'); — JSON API endpoint pro ověření stavu aplikace.