Маршрутизация в PHP через index.php: от базовой настройки до сложных решений

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

Пример 1. Динамические параметры в пути с несколькими сегментами

Используется библиотека FastRoute для обработки /category/{slug}/article/{id}.

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

$dispatcher = FastRoute\simpleDispatcher(function(FastRoute\RouteCollector $r) {
    $r->addRoute('GET', '/category/{slug}/article/{id:\d+}', function($vars) {
        return "Категория: {$vars['slug']}, ID статьи: {$vars['id']}";
    });
});

$routeInfo = $dispatcher->dispatch($_SERVER['REQUEST_METHOD'], parse_url($_SERVER['REQUEST_URI'], PHP_URL_PATH));
if ($routeInfo[0] === FastRoute\Dispatcher::FOUND) {
    $handler = $routeInfo[1];
    $vars = $routeInfo[2];
    echo $handler($vars);
} else {
    http_response_code(404);
    echo 'Не найдено';
}

При запросе /category/tech/article/42 вывод: Категория: tech, ID статьи: 42

Пример 2. Middleware цепочка на самописном роутере

Добавление проверки аутентификации перед выполнением контроллера.

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

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

    public function get(string $path, callable $handler): void {
        $this->routes['GET'][$path] = $handler;
    }

    public function run(): void {
        $method = $_SERVER['REQUEST_METHOD'];
        $uri = parse_url($_SERVER['REQUEST_URI'], PHP_URL_PATH);

        if (!isset($this->routes[$method][$uri])) {
            http_response_code(404);
            echo 'Not Found';
            return;
        }

        $handler = $this->routes[$method][$uri];
        // Применяем middleware в цепочке
        $next = function() use ($handler) {
            return $handler();
        };

        foreach (array_reverse($this->globalMiddlewares) as $mw) {
            $next = function() use ($mw, $next) {
                return $mw($next);
            };
        }

        echo $next();
    }
}

$router = new RouterWithMiddleware();
$router->addGlobalMiddleware(function($next) {
    if (!isset($_SESSION['user'])) {
        http_response_code(401);
        return 'Требуется авторизация';
    }
    return $next();
});

$router->get('/dashboard', function() {
    return 'Привет, ' . $_SESSION['user'];
});

session_start();
$router->run();

Если пользователь не авторизован, выводится сообщение 'Требуется авторизация'. Иначе - приветствие.

Пример 3. Группировка маршрутов с общим префиксом (FastRoute)

Объединение маршрутов для админ-панели.

<?php
$dispatcher = FastRoute\simpleDispatcher(function(FastRoute\RouteCollector $r) {
    $r->addGroup('/admin', function (FastRoute\RouteCollector $r) {
        $r->addRoute('GET', '/users', 'admin_users_list');
        $r->addRoute('GET', '/users/{id:\d+}', 'admin_user_show');
        $r->addRoute('POST', '/users/{id:\d+}/delete', 'admin_user_delete');
    });
});

$routeInfo = $dispatcher->dispatch($_SERVER['REQUEST_METHOD'], parse_url($_SERVER['REQUEST_URI'], PHP_URL_PATH));
switch ($routeInfo[0]) {
    case FastRoute\Dispatcher::FOUND:
        $handler = $routeInfo[1];
        $vars = $routeInfo[2];
        // $handler - строка, можно вызвать соответствующий метод контроллера
        echo "Вызван обработчик: $handler, параметры: " . json_encode($vars);
        break;
    default:
        http_response_code(404);
        echo 'Not Found';
        break;
}

При GET /admin/users/5 вывод: Вызван обработчик: admin_user_show, параметры: {"id":"5"}

Пример 4. Использование атрибутов PHP 8 для определения маршрутов (экспериментально)

Создание роутера, который читает атрибуты классов-контроллеров.

<?php
#[Attribute(\Attribute::TARGET_METHOD)]
class Route {
    public function __construct(public string $path, public string $method = 'GET') {}
}

class IndexController {
    #[Route('/', 'GET')]
    public function home(): string { return 'Home page'; }

    #[Route('/info', 'GET')]
    public function info(): string { return 'Info page'; }
}

$reflector = new ReflectionClass(IndexController::class);
$uri = parse_url($_SERVER['REQUEST_URI'], PHP_URL_PATH);

foreach ($reflector->getMethods() as $method) {
    $attributes = $method->getAttributes(Route::class);
    foreach ($attributes as $attr) {
        $route = $attr->newInstance();
        if ($route->path === $uri && $route->method === $_SERVER['REQUEST_METHOD']) {
            $controller = new IndexController();
            echo $controller->{$method->getName()}();
            exit;
        }
    }
}
http_response_code(404);
echo '404 Not Found';

При запросе /info выводится 'Info page'. При неизвестном URL - 404.