Tenké Controllery a neprůstřelná validace vstupů

Architektura tenkého Controlleru (Thin Controller)

Controller v čisté architektuře plní roli dirigenta:

1. Přijme HTTP požadavek (Request).
2. Provede striktní validaci vstupních dat.
3. Předá řízení specializovaným doménovým třídám (Services, Actions).
4. Zformátuje a vrátí HTTP odpověď (Blade pohled nebo JSON).

V moderním Laravelu se striktně vyhýbáme tzv. „tlustým controllerům“ (Fat Controllers). Controller nesmí přímo provádět složité výpočty, přímé zápisy na disk nebo nekonečné řetězce SQL dotazů.

1. Dependency Injection přímo do akcí Controlleru (Method Injection)

Všimni si našeho CourseController.php. Laravel disponuje mocným mechanismem Method Injection:

public function index(
    Request $request,
    StudentProgressService $progressService,
    AnatomyInspectorService $inspectorService,
): View {
    // Service Container automaticky vytvořil a předal obě služby!
}

Service Container frameworku pomocí reflexe zanalyzuje typové deklarace parametrů metody a automaticky vytvoří a předá potřebné instance služeb se všemi jejich závislostmi. Není potřeba psát manuální new ani volat app()->make().

2. Eager Loading pro prevenci N+1 dotazů v Controlleru

Častou chybou začátečníků je načítání relačních dat v cyklu:

// ŠPATNĚ: Způsobí N+1 dotazů do PostgreSQL!
$modules = CourseModule::all();
// Později v šabloně: $module->lessons (pro každý modul nový SQL SELECT!)

V CourseController::index() uplatňujeme striktní Eager Loading:

$modules = CourseModule::with(['lessons.quizQuestions'])
    ->orderBy('number')
    ->get();

Laravel provede přesně 3 optimalizované SQL dotazy (jeden pro moduly, jeden pro všechny lekce s WHERE course_module_id IN (...) a jeden pro kvízové otázky), čímž udrží dobu odezvy databáze na jednotkách milisekund bez ohledu na velikost kurzu.

3. Neprůstřelná validace uživatelských vstupů

Nikdy nevěřte vstupům z klientské strany! V metodě CourseController::switchProfile() provádíme explicitní validaci:

public function switchProfile(
    Request $request,
    StudentProgressService $progressService,
): RedirectResponse {
    /** @var array{transfer_code: string} $validated */
    $validated = $request->validate([
        'transfer_code' => ['required', 'string', 'max:24'],
    ]);

    $profile = $progressService->findByTransferCode($validated['transfer_code']);

    if ($profile === null) {
        return back()->with('error', 'Přenosový kód nebyl nalezen.');
    }

    return redirect()
        ->route('course.index')
        ->with('success', 'Postup studenta byl úspěšně obnoven!');
}

Co se stane při nevalidním vstupu:

• Pokud uživatel odešle prázdný kód nebo text delší než 24 znaků, metoda $request->validate() okamžitě vyhodí výjimku ValidationException.
• Framework tuto výjimku automaticky zachytí, přesměruje uživatele zpět na předchozí stránku, uloží chybové zprávy do session a zachová původní formulářová data (old()). V Controlleru tak nemusíte psát žádný if ($validator->fails())!