Контроллеры
Назначение и когда использовать
Контроллеры принимают 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.