Роутер в PHP: от простого switch до гибкого класса

Расширенные примеры и редкие сценарии использования

Полноценная реализация Router с группировкой и префиксами

<?php
class Router {
    private array $routes = [];
    private array $middlewares = [];
    private string $prefix = '';
    private array $groupMiddleware = [];

    public function group(string $prefix, callable $callback, array $middlewares = []): void {
        $previousPrefix = $this->prefix;
        $previousMiddleware = $this->groupMiddleware;
        $this->prefix .= $prefix;
        $this->groupMiddleware = array_merge($this->groupMiddleware, $middlewares);
        $callback($this);
        $this->prefix = $previousPrefix;
        $this->groupMiddleware = $previousMiddleware;
    }

    public function add(string $method, string $pattern, callable $handler, string $name = null): void {
        $fullPattern = $this->prefix . $pattern;
        $this->routes[] = [
            'method' => strtoupper($method),
            'pattern' => $this->convertToRegex($fullPattern),
            'handler' => $handler,
            'name' => $name,
            'middlewares' => $this->groupMiddleware
        ];
    }

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

    public function dispatch(string $method, string $uri): void {
        $method = strtoupper($method);
        $uri = parse_url($uri, PHP_URL_PATH);
        foreach ($this->routes as $route) {
            if ($route['method'] !== $method) continue;
            if (!preg_match($route['pattern'], $uri, $matches)) continue;
            $params = array_filter($matches, 'is_string', ARRAY_FILTER_USE_KEY);
            $request = ['method' => $method, 'uri' => $uri, 'params' => $params];
            // Выполнение middleware группы и глобальных
            foreach ($route['middlewares'] as $mw) {
                if ($mw($request) === false) return;
            }
            foreach ($this->middlewares as $mw) {
                if ($mw($request) === false) return;
            }
            call_user_func($route['handler'], $params);
            return;
        }
        http_response_code(404);
        echo json_encode(['error' => 'Route not found']);
    }
}

Этот класс поддерживает вложенные группы с собственными middleware и префиксами, а также позволяет задавать типы параметров через двоеточие (например, {id:\d+}).

Маршрутизация для REST API с разными форматами ответа

<?php
$router = new Router();
$router->add('GET', '/api/users', function($params) {
    header('Content-Type: application/json');
    echo json_encode(['users' => ['Alice', 'Bob']]);
}, 'users.list');

$router->add('GET', '/api/users/{id}', function($params) {
    header('Content-Type: application/json');
    echo json_encode(['user_id' => $params['id']]);
}, 'users.show');

$router->add('POST', '/api/users', function($params) {
    $input = json_decode(file_get_contents('php://input'), true);
    // Сохранение пользователя
    echo json_encode(['status' => 'created']);
}, 'users.create');

// Использование именованных маршрутов для генерации URL
function route(string $name, array $params = []): string {
    global $router;
    // В упрощённом виде - обычно имя хранится в отдельном массиве
    return '/api/users/' . ($params['id'] ?? '');
}

echo route('users.show', ['id' => 42]); // /api/users/42

/api/users/42

Пример демонстрирует, как использовать роутер для типичного REST эндпоинта с JSON и именованными маршрутами.

Обработка middleware для аутентификации

<?php
$router->addMiddleware(function($request) {
    $token = $_SERVER['HTTP_AUTHORIZATION'] ?? '';
    if (empty($token)) {
        http_response_code(401);
        echo json_encode(['error' => 'Unauthorized']);
        return false; // останавливаем цепочку
    }
    return true;
});

$router->add('GET', '/admin', function($params) {
    echo 'Admin panel';
});

Middleware проверяет токен перед выполнением любого маршрута. Если вернуть false, обработка прекращается.

Кэширование списка маршрутов для ускорения

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

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

    public function getRoutesForCache(): array {
        return $this->routes;
    }

    public function setRoutesFromCache(array $routes): void {
        $this->cachedRoutes = $routes;
    }

    public function dispatch(string $method, string $uri): void {
        $routes = $this->cachedRoutes ?? $this->routes;
        // ... остальная логика
    }
}

// Пример кэширования в файл
$router = new Router();
// ... регистрация маршрутов
file_put_contents('routes.cache', serialize($router->getRoutesForCache()));

// При следующем запросе
$cached = unserialize(file_get_contents('routes.cache'));
$router->setRoutesFromCache($cached);

Этот подход ускоряет работу, сокращая время на компиляцию регулярных выражений при каждом запросе.