Модуль маршрутов PHP: практические подходы и примеры

Расширенные примеры и продвинутые сценарии

1. Именованные маршруты с генерацией URL

Многие роутеры позволяют назначать имена маршрутам и генерировать по ним URL. Это упрощает рефакторинг. Пример с FastRoute (не встроено, но можно добавить):

<?php
class NamedRouteCollector extends FastRoute\RouteCollector {
    private array $namedRoutes = [];

    public function addNamedRoute($httpMethod, $route, $handler, $name): void {
        $this->addRoute($httpMethod, $route, $handler);
        $this->namedRoutes[$name] = ['method' => $httpMethod, 'route' => $route];
    }

    public function generate($name, array $params = []): string {
        if (!isset($this->namedRoutes[$name])) {
            throw new InvalidArgumentException("Route $name not found");
        }
        $route = $this->namedRoutes[$name]['route'];
        foreach ($params as $key => $value) {
            $route = str_replace('{' . $key . '}', $value, $route);
        }
        return $route;
    }
}

$collector = new NamedRouteCollector(new FastRoute\RouteParser\Std());
$collector->addNamedRoute('GET', '/user/{id}', 'handler', 'user.show');
echo $collector->generate('user.show', ['id' => 42]); // /user/42

Результат:

/user/42

2. Группировка маршрутов с префиксами

Часто нужно создать группу маршрутов с общим префиксом, например, /api/v1. FastRoute поддерживает группы через callback.

<?php
$dispatcher = FastRoute\simpleDispatcher(function(FastRoute\RouteCollector $r) {
    $r->addGroup('/api/v1', function (FastRoute\RouteCollector $r) {
        $r->addRoute('GET', '/users', 'listUsers');
        $r->addRoute('POST', '/users', 'createUser');
    });
});
// GET /api/v1/users -> listUsers

3. Middleware и маршрутизация на основе PSR-15

Использование PSR-15 (Request Handler) позволяет добавлять слои middleware до и после обработчика маршрута. Пример с библиотекой league/route:

composer require league/route

<?php
use League\Route\Router;
use Laminas\Diactoros\ServerRequestFactory;
use Laminas\HttpHandlerRunner\Emitter\SapiEmitter;

$router = new Router;

$router->middleware(function ($request, $handler) {
    // Логирование запроса
    $response = $handler->handle($request);
    return $response->withHeader('X-Powered-By', 'League Route');
});

$router->map('GET', '/hello/{name}', function ($request, array $args) {
    $response = new Laminas\Diactoros\Response();
    $response->getBody()->write('Hello ' . htmlspecialchars($args['name']));
    return $response;
});

$response = $router->dispatch(ServerRequestFactory::fromGlobals());
(new SapiEmitter)->emit($response);

4. Использование замыканий и контейнера зависимостей

Роутер может разрешать обработчики из контейнера, что даёт внедрение зависимостей. Пример с Pimple и собственным роутером:

<?php
$container = new Pimple\Container();
$container['UserController'] = function ($c) {
    return new UserController($c['db']);
};

// В роутере при обработке используем $container[$handlerName]
// FastRoute поддерживает подстановку строковых имён как callback.
$dispatcher = FastRoute\simpleDispatcher(function($r) use ($container) {
    $r->addRoute('GET', '/users/{id}', 'UserController::show');
});

// В dispatch вызываем: $handler = $routeInfo[1];
list($class, $method) = explode('::', $handler);
$controller = $container[$class];
echo $controller->$method($vars);

5. Обработка ошибок и кастомные 404/405

При использовании FastRoute можно определить собственные замыкания для NotFound и MethodNotAllowed, обернув их в класс.

<?php
$dispatcher = FastRoute\simpleDispatcher(...);

$routeInfo = $dispatcher->dispatch($httpMethod, $uri);
switch ($routeInfo[0]) {
    case FastRoute\Dispatcher::NOT_FOUND:
        $handler = function() {
            http_response_code(404);
            echo json_encode(['error' => 'Not Found'], JSON_UNESCAPED_UNICODE);
        };
        $handler();
        break;
    // ...
}

Это удобно для API, где нужно возвращать JSON.