Организация маршрутов в PHP: от простых решений до профессиональных инструментов

Расширенные примеры реализации маршрутизации

Приведём более сложные сценарии, которые часто встречаются на практике.

Пример 1: Роутер с middleware в собственном классе

<?php
class RouterWithMiddleware {
    private array $routes = [];
    private array $globalMiddlewares = [];

    public function addMiddleware(callable $middleware): void {
        $this->globalMiddlewares[] = $middleware;
    }

    public function add(string $pattern, array $handlers): void {
        $this->routes[] = [
            'pattern' => $this->convertToRegex($pattern),
            'handlers' => $handlers, // [middleware, ..., controller]
        ];
    }

    private function convertToRegex(string $pattern): string {
        return '#^' . preg_replace('/\{([a-zA-Z_]+)\}/', '(?P<$1>[^/]+)', $pattern) . '$#';
    }

    public function dispatch(string $uri): void {
        $uri = parse_url($uri, PHP_URL_PATH);
        foreach ($this->routes as $route) {
            if (preg_match($route['pattern'], $uri, $matches)) {
                $params = array_filter($matches, 'is_string', ARRAY_FILTER_USE_KEY);
                $handlers = array_merge($this->globalMiddlewares, $route['handlers']);
                $this->runPipeline($handlers, $params);
                return;
            }
        }
        http_response_code(404);
        echo 'Not Found';
    }

    private function runPipeline(array $handlers, array $params): void {
        $pipe = array_reduce(array_reverse($handlers), function($next, $handler) use ($params) {
            return function() use ($handler, $next, $params) {
                return $handler($params, $next);
            };
        }, function() {});
        $pipe();
    }
}

// Использование
$router = new RouterWithMiddleware();
$router->addMiddleware(function($params, $next) {
    echo 'Глобальный middleware выполнен<br>';
    $next();
});
$router->add('/admin/{action}', [
    function($params, $next) {
        // Проверка авторизации
        if (session_status() === PHP_SESSION_NONE) session_start();
        if (empty($_SESSION['user'])) {
            echo 'Доступ запрещён';
            exit;
        }
        $next();
    },
    function($params) {
        echo 'Действие: ' . $params['action'];
    }
]);
$router->dispatch('/admin/create');
?>

Результат выполнения (при авторизованном пользователе):

Глобальный middleware выполнен
Действие: create

Пример 2: Группировка маршрутов с общим префиксом в FastRoute

<?php
$dispatcher = FastRoute\simpleDispatcher(function(FastRoute\RouteCollector $r) {
    $r->addGroup('/api', function (FastRoute\RouteCollector $r) {
        $r->addRoute('GET', '/users', 'getUsers');
        $r->addRoute('POST', '/users', 'createUser');
        $r->addRoute('GET', '/users/{id:\d+}', 'getUser');
    });
    $r->addGroup('/admin', function (FastRoute\RouteCollector $r) {
        $r->addRoute('GET', '/dashboard', 'adminDashboard');
        $r->addRoute('GET', '/settings', 'adminSettings');
    });
});
// Далее dispatch как в базовом примере
?>

Такой подход упрощает поддержку и читаемость кода.

Пример 3: Кэширование маршрутов FastRoute для production

<?php
$cacheFile = __DIR__ . '/route_cache.php';

if (file_exists($cacheFile)) {
    $dispatcher = require $cacheFile;
} else {
    $dispatcher = FastRoute\cachedDispatcher(function(FastRoute\RouteCollector $r) {
        $r->addRoute('GET', '/', 'home');
        $r->addRoute('GET', '/news/{slug}', 'news');
    }, [
        'cacheFile' => $cacheFile,
        'cacheDisabled' => false,
    ]);
}
// dispatch as usual
?>

Кэширование ускоряет загрузку маршрутов на 50-70%.

Пример 4: Преобразование параметров (конвертеры) в Symfony Routing

use Symfony\Component\Routing\Route;
use Symfony\Component\Routing\RouteCollection;

$routes = new RouteCollection();
$route = new Route('/blog/{slug}', [
    '_controller' => 'App\Controller\BlogController::show',
], [
    'slug' => '[a-z0-9-]+'
]);
// Добавим конвертер параметра
$route->setOption('utf8', true);
$route->addDefaults(['slug' => 'default']);
$routes->add('blog_show', $route);

// Или через YAML с опцией requirements
// blog_show:
//     path: /blog/{slug}
//     controller: App\Controller\BlogController::show
//     requirements:
//         slug: '[a-z0-9-]+'

Можно также реализовать собственные конвертеры, реализовав интерфейс ValueResolverInterface.

Пример 5: Генерация URL по имени маршрута (Symfony Router)

use Symfony\Component\Routing\Generator\UrlGenerator;
use Symfony\Component\Routing\RequestContext;

$generator = new UrlGenerator($routes, new RequestContext('/'));
echo $generator->generate('user_show', ['id' => 42]);
// Выведет: /user/42

Это удобно для создания ссылок без жёсткой привязки к структуре URL.