Создание маршрутов в PHP: от простого парсинга до готовых решений

Как реализовать роутер с поддержкой middleware (фильтров) и вложенных групп?

Пример объектно-ориентированного роутера, который поддерживает группы с общим префиксом и промежуточные обработчики.

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

    public function group(string $prefix, callable $callback, array $middleware = []): void {
        $callback(new GroupRouter($this, $prefix, $middleware));
    }

    public function add(string $method, string $path, callable $handler, array $middleware = []): void {
        $this->routes[] = compact('method', 'path', 'handler', 'middleware');
    }

    public function dispatch(string $method, string $uri): void {
        foreach ($this->routes as $route) {
            $pattern = preg_replace('/\{([a-zA-Z_]+)\}/', '(?P<$1>[^/]+)', $route['path']);
            $pattern = '#^' . $pattern . '$#';
            if ($route['method'] === $method && preg_match($pattern, $uri, $matches)) {
                // Применить middleware
                foreach ($route['middleware'] as $mw) {
                    if (!(new $mw)->handle()) return;
                }
                $params = array_filter($matches, 'is_string', ARRAY_FILTER_USE_KEY);
                call_user_func($route['handler'], $params);
                return;
            }
        }
        http_response_code(404);
        echo 'Not Found';
    }
}

class GroupRouter {
    public function __construct(
        private Router $router,
        private string $prefix,
        private array $middleware
    ) {}
    public function add(string $method, string $path, callable $handler, array $middleware = []): void {
        $this->router->add(
            $method,
            $this->prefix . $path,
            $handler,
            array_merge($this->middleware, $middleware)
        );
    }
}

// Использование
$router = new Router();
$router->group('/admin', function (GroupRouter $r) {
    $r->add('GET', '/users', function ($params) { echo 'Список пользователей'; });
    $r->add('GET', '/user/{id}', function ($params) { echo 'Пользователь ' . $params['id']; });
}, ['AuthMiddleware']);

$router->dispatch($_SERVER['REQUEST_METHOD'], parse_url($_SERVER['REQUEST_URI'], PHP_URL_PATH));

Результат: при запросе GET /admin/users сначала выполняется AuthMiddleware, затем обработчик.

(если авторизован) Список пользователей

Как генерировать URL по имени маршрута (reverse routing)?

В больших приложениях полезно не прописывать URL вручную, а генерировать их из имени маршрута с подстановкой параметров.

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

    public function add(string $name, string $pattern, callable $handler): void {
        $this->routes[$name] = compact('pattern', 'handler');
    }

    public function generate(string $name, array $params = []): string {
        if (!isset($this->routes[$name])) {
            throw new Exception("Маршрут '$name' не найден");
        }
        $url = $this->routes[$name]['pattern'];
        foreach ($params as $key => $value) {
            $url = str_replace("{$key}", $value, $url);
        }
        // Удалить оставшиеся плейсхолдеры (если не все переданы) - на усмотрение
        return $url;
    }
}

$routes = new RouteCollection();
$routes->add('user.show', '/user/{id}', function($id) { echo "User $id"; });
$routes->add('post.show', '/post/{slug}', function($slug) { echo "Post $slug"; });

// Использование
$url = $routes->generate('user.show', ['id' => 42]);
echo $url; // /user/42

/user/42

Как обрабатывать URL с поддержкой мультиязычности (префикс языка)?

Маршрутизация с извлечением кода языка из начала URI.

<?php
$uri = parse_url($_SERVER['REQUEST_URI'], PHP_URL_PATH);
$supportedLocales = ['en', 'ru', 'de'];
$locale = 'en'; // по умолчанию

$parts = explode('/', trim($uri, '/'));
if (!empty($parts[0]) && in_array($parts[0], $supportedLocales)) {
    $locale = array_shift($parts);
    $uri = '/' . implode('/', $parts);
}

// Далее стандартный роутинг с $uri
$routes = [
    '/' => 'HomeController@index',
    '/about' => 'PageController@about',
];
if (isset($routes[$uri])) {
    // … вызов контроллера, передача $locale
    echo "Текущий язык: $locale";
}

Результат для URL /ru/about: язык ru, маршрут /about.

Текущий язык: ru

Как интегрировать каталог URL с Dependency Injection Container для автоматического разрешения контроллеров?

Пример с использованием простого DI контейнера (например, PHP-DI).

<?php
require 'vendor/autoload.php';

$container = new DI\Container();

$dispatcher = FastRoute\simpleDispatcher(function(FastRoute\RouteCollector $r) use ($container) {
    $r->addRoute('GET', '/user/{id}', function($id) use ($container) {
        $controller = $container->get('UserController');
        return $controller->show($id);
    });
});

$routeInfo = $dispatcher->dispatch($_SERVER['REQUEST_METHOD'], $_SERVER['REQUEST_URI']);
if ($routeInfo[0] === FastRoute\Dispatcher::FOUND) {
    $handler = $routeInfo[1];
    $vars = $routeInfo[2];
    echo $handler($vars);
}

Результат: контроллер UserController получает экземпляры зависимостей через контейнер.