Middleware pipeline: Jak filtrovat a obohacovat HTTP požadavky

Co je to Middleware a jak funguje HTTP Pipeline

Middleware představuje ochranný mechanismus a filtrační vrstvu, kterou musí projít každý příchozí HTTP požadavek předtím, než dorazí k aplikační logice v Controlleru. Stejně tak výstupní HTTP odpověď (Response) prochází toutéž pipeline opačným směrem zpět ke klientovi.

Tento koncept vychází z návrhového vzoru Pipeline (nebo Chain of Responsibility), často přirovnávaného ke slupkám cibule:

[ Příchozí Request ]
        │
        ▼
┌──────────────────────────────────────────────┐
│  EnsureStudentProfile (Ověření identity)    │
│  ┌────────────────────────────────────────┐  │
│  │  VerifyCsrfToken / EncryptCookies      │  │
│  │  ┌──────────────────────────────────┐  │  │
│  │  │  CourseController::index()       │  │  │
│  │  │  (Generování pohledu / dat)      │  │  │
│  │  └──────────────────────────────────┘  │  │
│  │  Zpětný průchod: Šifrování odpovědi    │  │
│  └────────────────────────────────────────┘  │
│  Zpětný průchod: Připojení cookie studenta   │
└──────────────────────────────────────────────┘
        │
        ▼
[ Odchozí Response s HTTP hlavičkami ]

1. Anatomie Middleware třídy v PHP 8.4

V moderním Laravelu 12 píšeme middleware jako neměnnou třídu se striktním typováním:

final readonly class EnsureStudentProfile
{
    public function __construct(
        private StudentProgressService $progressService,
    ) {}

    public function handle(Request $request, Closure $next): Response
    {
        // 1. Předání řízení dovnitř aplikace (Before middleware fáze)
        $rawToken = $request->cookie(StudentProgressService::COOKIE_NAME);
        $profile = $this->progressService->resolveProfile($rawToken);

        $request->attributes->set('studentProfile', $profile);
        View::share('currentStudent', $profile);

        // 2. Volání další vrstvy v řetězci ($next)
        $response = $next($request);

        // 3. Obohacení odchozí odpovědi (After middleware fáze)
        $cookie = cookie(
            name: StudentProgressService::COOKIE_NAME,
            value: $profile->token,
            minutes: 525600, // Platnost 1 rok
        );

        $response->headers->setCookie($cookie);

        return $response;
    }
}

Klíčové fáze metody handle():

• Před voláním $next($request): Zde můžete požadavek validovat, odmítnout (např. vrátit abort(403)), vyčistit data nebo injektovat dodatečné atributy přes $request->attributes->set().
• Volání $next($request): Tímto krokem middleware předává řízení dalšímu prvku pipeline (dalšímu middlewaru nebo samotnému controlleru).
• Po volání $next($request): Zde již držíte hotový objekt $response. Můžete upravovat HTTP hlavičky, připojovat cookies nebo měnit stavový kód.

2. Registrace Middleware v Laravelu 12 (bootstrap/app.php)

V Laravelu 12 došlo k revoluci v konfiguraci. Starý soubor app/Http/Kernel.php byl zrušen a veškerá konfigurace middleware se nyní provádí přímo ve fluent bootstrap souboru bootstrap/app.php:

return Application::configure(basePath: dirname(__DIR__))
    ->withRouting(
        web: __DIR__.'/../routes/web.php',
        commands: __DIR__.'/../routes/console.php',
        health: '/up',
    )
    ->withMiddleware(function (Middleware $middleware): void {
        $middleware->web(append: [
            EnsureStudentProfile::class,
        ]);
    })
    ->create();

Metoda $middleware->web(append: [...]) zařadí náš middleware na konec výchozí skupiny web (za inicializaci session, šifrování cookies a ochranu CSRF). Díky tomu má náš middleware okamžitě k dispozici dekódované cookies!