Маршрутизация
Назначение и когда использовать
Esora\Routing\Router связывает HTTP-метод и URI с обработчиком. Используйте его для публичных страниц, JSON API и групп маршрутов; сложные действия выносите в контроллеры из раздела Контроллеры.
Создание и регистрация
Маршруты регистрируются в app/Features/<Feature>/routes.php. Файл получает экземпляр $router:
use App\Features\Blog\Controllers\PostController;
use Esora\Routing\Router;
/** @var Router $router */
$router->get('/posts', [PostController::class, 'index'])->name('posts.index');
$router->post('/posts', [PostController::class, 'store'])->middleware('csrf');
$router->get('/posts/{id}', [PostController::class, 'show'])->where('id', '\d+');
FeatureManager автоматически загружает routes.php каждой директории app/Features. Проверяйте результат командой php bin/console route:list.
API
get, post, put, patch, delete, options принимают string $path и mixed $handler, возвращают Route. match(array $methods, string $path, mixed $handler) регистрирует выбранные методы, any(...) — все поддержанные методы.
У Route доступны цепочки name(string $name), middleware(string|array $middleware) и where(string|array $param, ?string $pattern = null). Префикс и middleware можно применить к группе:
$router->group(['prefix' => 'admin', 'middleware' => ['auth', 'rate-limit']], function (Router $router): void {
$router->get('/reports/{year?}', [ReportController::class, 'index'])
->where('year', '\d{4}');
});
dispatch(string $method, string $uri) возвращает RouteMatch, а при отсутствии маршрута выбрасывает RouteNotFoundException; совпавший URI с неподдержанным методом вызывает MethodNotAllowedException. getRoutes() возвращает зарегистрированные Route.
Lifecycle
- Feature discovery находит
routes.php. RouterсоздаётRouteи сохраняет параметры ограничений и middleware.- HTTP Kernel вызывает
dispatch(). - Kernel разрешает параметры URI и вызывает handler.
- Ответ проходит middleware и отправляется клиенту.
Troubleshooting
404: проверьте slug/path, наличие feature иroute:list.405: URI найден, но HTTP-метод не зарегистрирован.- Параметр не совпадает:
where()получает регулярное выражение без разделителей. - Маршрут не загрузился: файл должен называться
routes.php, а feature находиться непосредственно вapp/Features.