Общий маршрут PHP: как работает front controller

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

Пример 1: Маршруты с группировкой и middleware (на основе самописного роутера)

Добавим поддержку групп маршрутов (префиксов) и middleware - функций, выполняемых перед обработчиком. Это удобно для проверки авторизации или логирования.

<?php
// index.php - улучшенный роутер

class Router {
    private $routes = [];
    private $before = []; // глобальные middleware
    
    public function add($method, $pattern, $handler, $middleware = null) {
        $this->routes[] = compact('method', 'pattern', 'handler', 'middleware');
    }
    
    public function group($prefix, $callback) {
        // Сохраняем текущий префикс, вызываем callback, восстанавливаем
        // Упрощённо: передаём префикс через контекст
        $callback($this, $prefix);
    }
    
    public function run() {
        $uri = parse_url($_SERVER['REQUEST_URI'], PHP_URL_PATH);
        $method = $_SERVER['REQUEST_METHOD'];
        
        foreach ($this->routes as $route) {
            // Поддержка префикса: сразу добавим его в шаблон
            $regex = preg_replace('/\{[a-zA-Z_]+\}/', '([^/]+)', $route['pattern']);
            $regex = '#^' . $regex . '$#';
            if (preg_match($regex, $uri, $matches) && $route['method'] === $method) {
                array_shift($matches);
                // Выполняем middleware, если есть
                if ($route['middleware']) {
                    $result = call_user_func($route['middleware'], $uri, $matches);
                    if ($result === false) {
                        http_response_code(403);
                        echo 'Доступ запрещён';
                        return;
                    }
                }
                // Выполняем обработчик
                call_user_func_array($route['handler'], $matches);
                return;
            }
        }
        http_response_code(404);
        echo 'Не найдено';
    }
}

// Использование
$router = new Router();

// Глобальный middleware для логирования
$loggerMiddleware = function($uri, $params) {
    error_log("Запрос: $uri");
    return true;
};

// Можно добавить глобальные фильтры (не показаны)

// Определяем маршруты
$router->add('GET', '/', function() { echo 'Главная'; }, $loggerMiddleware);
$router->add('GET', '/about', function() { echo 'О нас'; });

// Группа /admin с middleware авторизации
$authMiddleware = function($uri, $params) {
    if (!isset($_SESSION['user'])) {
        header('Location: /login');
        return false;
    }
    return true;
};
$router->add('GET', '/admin', function() { echo 'Админка'; }, $authMiddleware);
$router->add('GET', '/admin/users', function() { echo 'Список пользователей'; }, $authMiddleware);

$router->run();

// Результат при посещении /admin без сессии: редирект на /login

Пример 2: Использование регулярных выражений с именованными группами

Самописный роутер можно улучшить, применяя именованные группы захвата в регулярных выражениях. Это позволяет передавать параметры по имени.

<?php
$uri = '/user/john/25/';
$patterns = [
    '/user/{name}/{age}/' => 'user_handler',
];
foreach ($patterns as $pattern => $handler) {
    // Преобразуем {name} в (?P<name>[^/]+)
    $regex = preg_replace('/\{([a-zA-Z_]+)\}/', '(?P<$1>[^/]+)', $pattern);
    $regex = '#^' . $regex . '$#';
    if (preg_match($regex, $uri, $matches)) {
        $params = array_filter($matches, 'is_string', ARRAY_FILTER_USE_KEY); // только именованные
        // $params = ['name' => 'john', 'age' => '25']
        call_user_func($handler, $params);
    }
}

// Параметры передаются ассоциативным массивом

Пример 3: Маршрутизация с поддержком различных HTTP-методов (POST, PUT, DELETE)

В реальном приложении важно учитывать не только URI, но и HTTP-метод. Пример на основе FastRoute (который поддерживает это из коробки).

<?php
$dispatcher = FastRoute\simpleDispatcher(function(FastRoute\RouteCollector $r) {
    $r->addRoute('GET', '/user/{id:\d+}', 'getUser');
    $r->addRoute('POST', '/user', 'createUser');
    $r->addRoute('PUT', '/user/{id:\d+}', 'updateUser');
    $r->addRoute('DELETE', '/user/{id:\d+}', 'deleteUser');
});

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

$routeInfo = $dispatcher->dispatch($httpMethod, $uri);
if ($routeInfo[0] === FastRoute\Dispatcher::FOUND) {
    $handler = $routeInfo[1];
    $vars = $routeInfo[2];
    echo "Обработчик: $handler, параметры: " . json_encode($vars);
} else {
    http_response_code(404);
    echo 'Not Found';
}

// При GET /user/123 - выведет: Обработчик: getUser, параметры: ["id":"123"]
// При POST /user - Обработчик: createUser, параметры: []

Пример 4: Генерация URL по имени маршрута в AltoRouter

Функция generate упрощает создание ссылок, особенно при изменении путей.

<?php
$router = new AltoRouter();
$router->map('GET', '/product/[i:id]/[a:slug]', 'product_show', 'ProductController#show');

// Генерация URL:
$url = $router->generate('product_show', ['id' => 10, 'slug' => 'laptop']);
// Результат: /product/10/laptop
echo $url;

/product/10/laptop

Пример 5: Обработка ошибок 404 с сохранением пути

Иногда нужно перенаправить пользователя на специальную страницу 404, но при этом запомнить, какой путь был запрошен.

<?php
// В самописном роутере после цикла, если маршрут не найден:
$requestedPath = $_SERVER['REQUEST_URI'];
http_response_code(404);
include '404.php'; // в 404.php можно вывести $requestedPath

// Пользователь увидит: "Страница /wrong-path не найдена"

Эти примеры охватывают большинство сценариев использования маршрутизации через index.php: от простых статических путей до продвинутой группировки и генерации URL.