⚡ Esora Документация

Контроллеры

Назначение и когда использовать

Контроллеры принимают PSR-7 request, выполняют orchestration и возвращают ResponseInterface. Используйте контроллер вместо анонимного callback, когда действие содержит валидацию, работу с БД или несколько ответов.

Создание

php bin/console make:controller PostController

Команда создаёт контроллер в текущей feature. Реальный handler может принимать request и параметры маршрута:

namespace App\Features\Blog\Controllers;

use Esora\Http\ResponseFactory;
use Psr\Http\Message\ResponseInterface;
use Psr\Http\Message\ServerRequestInterface;

final class PostController
{
    public function show(ServerRequestInterface $request, string $id): ResponseInterface
    {
        return ResponseFactory::json([
            'id' => $id,
            'query' => $request->getQueryParams(),
        ]);
    }
}

Зарегистрируйте [PostController::class, 'show'] в routes.php (см. Маршрутизация). ResponseFactory::json(mixed $data, int $status = 200, array $headers = []), text(string $text, ...) и html(string $html, ...) создают ответы.

Lifecycle

Kernel получает ServerRequestInterface, находит handler через Router, разрешает type-hinted request и route parameters, вызывает метод, затем передаёт результат через middleware. Для HTML сначала отрендерите ViewEngine, а пользовательский ввод экранируйте.

FormRequest

Сложную проверку оформляйте классом FormRequest: конструктор сразу вызывает authorize() и validation. Переопределите authorize(): bool и rules(): array; после успешного создания используйте validated(), all(), input(string $key, mixed $default = null).

final class StorePostRequest extends FormRequest
{
    public function authorize(): bool { return true; }
    public function rules(): array
    {
        return ['title' => 'required|string|min:3|max:120'];
    }
}

Troubleshooting

  • Возвращайте именно ResponseInterface; массив сам по себе не является ответом.
  • Имя метода и параметры должны совпадать с зарегистрированным handler.
  • Ошибка авторизации FormRequest — исключение с HTTP 403; ошибка правил — ValidationException.