Реализация системы маршрутизации для PHP проектов

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

В этом разделе приведены более детальные реализации каждого подхода с полным кодом и результатом работы.

Пример 1: Полноценный роутер с поддержкой именованных маршрутов и генерации URL

Расширим класс Router, добавив возможность давать маршрутам имена и генерировать по ним URL. Это полезно для шаблонов.

class Router {
    private array $routes = [];
    private array $namedRoutes = [];

    public function add(string $method, string $pattern, callable $handler, ?string $name = null): void {
        $compiled = $this->compilePattern($pattern);
        $this->routes[] = [
            'method'  => $method,
            'pattern' => $compiled,
            'handler' => $handler,
            'name'    => $name,
        ];
        if ($name) {
            $this->namedRoutes[$name] = $pattern;
        }
    }

    private function compilePattern(string $pattern): string {
        // поддержка {param} и {param:regex}
        return preg_replace_callback('/\{([a-zA-Z_]+)(?::([^}]+))?\}/', function($match) {
            $name = $match[1];
            $regex = $match[2] ?? '[^/]+';
            return '(?P<' . $name . '>' . $regex . ')';
        }, $pattern);
    }

    public function dispatch(string $method, string $uri): void {
        $uri = parse_url($uri, PHP_URL_PATH);
        foreach ($this->routes as $route) {
            if ($route['method'] !== $method) continue;
            if (preg_match('#^' . $route['pattern'] . '$#', $uri, $matches)) {
                $params = array_filter($matches, 'is_string', ARRAY_FILTER_USE_KEY);
                call_user_func($route['handler'], $params);
                return;
            }
        }
        http_response_code(404);
        echo "404 - Not Found";
    }

    public function generateUrl(string $name, array $params = []): string {
        if (!isset($this->namedRoutes[$name])) {
            throw new Exception("Route '$name' not found.");
        }
        $pattern = $this->namedRoutes[$name];
        foreach ($params as $key => $value) {
            $pattern = str_replace('{' . $key . '}', $value, $pattern);
        }
        // Удаление оставшихся параметров (если не все заменены)
        return preg_replace('/\{[a-zA-Z_]+\}/', '', $pattern);
    }
}

// Использование:
$router = new Router();
$router->add('GET', '/user/{id:\d+}', function($params) {
    echo "Просмотр пользователя ID: " . $params['id'];
}, 'user.show');
$router->add('GET', '/user/{id}/post/{postId}', function($params) {
    echo "Пост $postId пользователя $id";
}, 'user.post');

// Генерация URL:
echo $router->generateUrl('user.show', ['id' => 42]); // /user/42
echo $router->generateUrl('user.post', ['id' => 1, 'postId' => 10]); // /user/1/post/10

/user/42
/user/1/post/10

Пример 2: Использование FastRoute с группами и middleware (через функцию-обёртку)

FastRoute поддерживает группы маршрутов с общим префиксом. Также можно встроить простую middleware-проверку.

require 'vendor/autoload.php';

use FastRoute\RouteCollector;
use FastRoute\Dispatcher;

$dispatcher = FastRoute\simpleDispatcher(function(RouteCollector $r) {
    $r->addGroup('/admin', function(RouteCollector $r) {
        $r->addRoute('GET', '', 'adminDashboard');
        $r->addRoute('GET', '/users', 'adminUsers');
    });
    $r->addRoute('GET', '/api/user/{id:\d+}', 'apiGetUser');
});

// Функция middleware для проверки аутентификации (упрощённо)
function authMiddleware(callable $next) {
    return function(...$args) use ($next) {
        session_start();
        if (!isset($_SESSION['user'])) {
            http_response_code(401);
            echo "Unauthorized";
            return;
        }
        call_user_func($next, ...$args);
    };
}

$httpMethod = $_SERVER['REQUEST_METHOD'];
$uri = parse_url($_SERVER['REQUEST_URI'], PHP_URL_PATH);

$routeInfo = $dispatcher->dispatch($httpMethod, $uri);

switch ($routeInfo[0]) {
    case Dispatcher::NOT_FOUND:
        http_response_code(404);
        echo "404";
        break;
    case Dispatcher::METHOD_NOT_ALLOWED:
        http_response_code(405);
        echo "405";
        break;
    case Dispatcher::FOUND:
        $handler = $routeInfo[1];
        $vars = $routeInfo[2];
        // Применение middleware
        if ($handler === 'adminDashboard' || $handler === 'adminUsers') {
            $handler = authMiddleware($handler);
        }
        call_user_func($handler, $vars);
        break;
}

Результат: при запросе /admin без сессии вернёт 401, с сессией - вызовет обработчик.

Пример 3: Кэширование маршрутов, полученных через атрибуты

Чтобы избежать рефлексии при каждом запросе, можно сохранить маршруты в файл и загружать их.

// cache.php - генерация кэша
function buildRouteCache(): array {
    $routes = [];
    $controllers = [UserController::class, PostController::class];
    foreach ($controllers as $class) {
        $refClass = new ReflectionClass($class);
        foreach ($refClass->getMethods() as $method) {
            $attrs = $method->getAttributes(Route::class);
            foreach ($attrs as $attr) {
                $route = $attr->newInstance();
                $routes[] = [
                    'method'  => $route->method,
                    'pattern' => $route->pattern,
                    'handler' => [$class, $method->getName()],
                ];
            }
        }
    }
    file_put_contents('routes_cache.php', '<?php return ' . var_export($routes, true) . ';');
    return $routes;
}

// В index.php:
if (file_exists('routes_cache.php')) {
    $routes = include 'routes_cache.php';
} else {
    $routes = buildRouteCache();
}
// Далее используем $routes для dispatch.

При изменении контроллеров нужно очищать кэш (например, при деплое).

Пример 4: Slim с контейнером зависимостей и middleware

Slim легко интегрируется с PSR-11 контейнером. Пример с использованием PHP-DI.

require 'vendor/autoload.php';

use Slim\Factory\AppFactory;
use DI\ContainerBuilder;

$containerBuilder = new ContainerBuilder();
$container = $containerBuilder->build();

AppFactory::setContainer($container);
$app = AppFactory::create();

$app->addErrorMiddleware(true, true, true);

// Middleware для логирования
$app->add(function ($request, $handler) {
    $response = $handler->handle($request);
    error_log('Request: ' . $request->getMethod() . ' ' . $request->getUri());
    return $response;
});

$app->get('/hello/{name}', function ($request, $response, $args) {
    $name = $args['name'];
    $response->getBody()->write("Hello, $name!");
    return $response;
});

$app->run();

Результат: при GET /hello/World выведет "Hello, World!" и запишет лог.