Kapitola 5 z 15

Controllery a HTTP responses.

Controller koordinuje jeden HTTP use case a své závislosti dostává konstruktorem.

Třída controlleru

Controller může být běžná final třída. Container jej vytvoří v Request scope, takže konstruktorem může přijmout i requestově scoped služby. Veřejné ponechte jen akce určené pro dispatch.

app/Controllers/ArticleController.php
<?php

declare(strict_types=1);

use Lemonade\Framework\View\ViewRendererInterface;
use Psr\Http\Message\ResponseInterface;

final readonly class ArticleController
{
    public function __construct(private ViewRendererInterface $views) {}

    public function detail(string $id): ResponseInterface
    {
        return $this->views->render('articles.detail', ['id' => $id]);
    }
}

Parametry routy přicházejí jako argumenty akce. ViewRendererInterface::render() vrací HTML odpověď podle PSR-7.

Typy odpovědí

Pro HTML view použijte ViewRendererInterface. Pro JSON, text, redirect, download nebo stream injektujte Responses.

Responses
<?php

declare(strict_types=1);

use Lemonade\Framework\Http\Response\Responses;
use Psr\Http\Message\ResponseInterface;

final readonly class HealthController
{
    public function __construct(private Responses $responses) {}

    public function show(): ResponseInterface
    {
        return $this->responses->json(['status' => 'ok']);
    }
}

Responses::json() používá bezpečné JSON kódování a umožňuje zadat HTTP status, například 201 nebo 422.

Podrobná technická dokumentace na GitHubu