Организация обработки всех запросов через index.php

Раздел: Веб-разработка на PHP -> Маршрутизация PHP

Организация единой точки входа через index.php

Как заставить веб-сервер перенаправлять все запросы на один скрипт index.php?

Самый распространенный способ - использование файла .htaccess (для Apache) или конфигурации сервера. Этот метод лежит в основе архитектуры Front Controller.

Шаг 1: Настройка сервера

Файл .htaccess создается в корневой директории приложения со следующим содержимым:

RewriteEngine On
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule ^(.*)$ index.php [QSA,L]

Эти директивы включают модуль mod_rewrite, проверяют, что запрашиваемый файл или директория не существуют, и перенаправляют все остальные запросы на index.php. Флаг QSA сохраняет строку запроса, а L останавливает обработку.

Шаг 2: Простой роутер в index.php

Самый простой вариант - разобрать URI и выполнить соответствующий код.

<?php
$uri = parse_url($_SERVER['REQUEST_URI'], PHP_URL_PATH);

switch ($uri) {
    case '/':
        echo 'Главная страница';
        break;
    case '/about':
        echo 'О нас';
        break;
    case '/contact':
        echo 'Контакты';
        break;
    default:
        http_response_code(404);
        echo 'Страница не найдена';
        break;
}

Такой подход подходит для небольших проектов, но быстро становится неудобным при росте количества маршрутов.

Типичные ошибки и проблемы:

Не работает .htaccess - следует убедиться, что модуль mod_rewrite включен и разрешено переопределение (AllowOverride All).
Путь к index.php неверен - если приложение находится в подпапке, в RewriteRule требуется указать соответствующий префикс.
Потеря параметров GET решается с помощью QSA.

Как настроить маршрутизацию на сервере Nginx?

Для Nginx директива rewrite записывается в блок server.

location / {
    try_files $uri $uri/ /index.php?$query_string;
}

Эта директива проверяет существование файла или директории, и если ничего не найдено, передает управление index.php с сохранением строки запроса.

Как использовать встроенный сервер PHP для маршрутизации?

PHP предоставляет собственный сервер для разработки. Запуск выполняется с указанием роутера:

php -S localhost:8000 index.php

Встроенный сервер автоматически отправляет все запросы на index.php, если файл не найден. Этот способ удобен для локальной разработки, но не для продакшена.

Как организовать маршрутизацию без .htaccess, используя только PHP?

Можно вручную обрабатывать переменную $_SERVER['REQUEST_URI'] в index.php. Это не требует настройки сервера, но все запросы должны физически указывать на index.php (например, через URL вида index.php?route=about).

<?php
$route = $_GET['route'] ?? '';
switch ($route) {
    case 'about':
        // ...
        break;
}

Недостаток - некрасивые URL. Для красивых URL все равно нужна серверная перезапись.

Как применить готовую библиотеку маршрутизации (например, FastRoute)?

Готовые решения упрощают обработку динамических параметров и middlewares.

<?php
require 'vendor/autoload.php';
$dispatcher = FastRoute\simpleDispatcher(function(FastRoute\RouteCollector $r) {
    $r->addRoute('GET', '/users/{id:\d+}', 'get_user_handler');
    $r->addRoute('GET', '/articles/{slug}', 'get_article_handler');
});
$routeInfo = $dispatcher->dispatch($httpMethod, $uri);
switch ($routeInfo[0]) {
    case FastRoute\Dispatcher::NOT_FOUND:
        // 404
        break;
    case FastRoute\Dispatcher::METHOD_NOT_ALLOWED:
        // 405
        break;
    case FastRoute\Dispatcher::FOUND:
        $handler = $routeInfo[1];
        $vars = $routeInfo[2];
        // вызов обработчика
        break;
}

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

Частые проблемы при реализации:

Некорректные регулярные выражения - рекомендуется тестировать шаблоны отдельно.
Конфликт маршрутов - порядок имеет значение.
Отсутствие валидации параметров - требуется фильтровать входные данные.

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

Пример с контроллерами и параметрами

Используются классы для каждого маршрута.

Пример

<?php
// index.php
spl_autoload_register(function ($class) {
    include 'controllers/' . $class . '.php';
});

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

$routes = [
    '/' => ['controller' => 'HomeController', 'action' => 'index'],
    '/users/{id}' => ['controller' => 'UserController', 'action' => 'show'],
];

foreach ($routes as $pattern => $cfg) {
    $pattern = preg_replace('/\{(\w+)\}/', '(?P<$1>[^/]+)', $pattern);
    $pattern = '#^' . $pattern . '$#';
    if (preg_match($pattern, $uri, $matches)) {
        $params = array_filter($matches, 'is_string', ARRAY_FILTER_USE_KEY);
        $controller = new $cfg['controller'];
        echo call_user_func_array([$controller, $cfg['action']], $params);
        exit;
    }
}
http_response_code(404);
echo 'Not Found';

При запросе /users/42 вызовется метод show класса UserController с параметром id=42.

Вывод: "Пользователь с ID: 42"

Пример с middleware

Добавляется проверка авторизации перед вызовом контроллера.

Пример

// добавлено в цикл маршрутизации
if (isset($cfg['middleware'])) {
    $middleware = new $cfg['middleware'];
    $middleware->handle($params, function() use ($controller, $cfg, $params) {
        echo call_user_func_array([$controller, $cfg['action']], $params);
    });
} else {
    echo call_user_func_array([$controller, $cfg['action']], $params);
}

Определение маршрута: '/admin' => ['controller'=>'AdminController', 'action'=>'index', 'middleware'=>'AuthMiddleware'].

При неавторизованном доступе: "Доступ запрещен"
При успешной авторизации: "Админ панель"

Группировка маршрутов с общим префиксом

Можно сгруппировать маршруты с одинаковым префиксом, например, API.

Пример

function groupRoutes($prefix, $routes) {
    $result = [];
    foreach ($routes as $route => $cfg) {
        $result[$prefix . $route] = $cfg;
    }
    return $result;
}
$apiRoutes = groupRoutes('/api/v1', [
    '/users' => ['controller' => 'ApiUserController', 'action' => 'list'],
    '/users/{id}' => ['controller' => 'ApiUserController', 'action' => 'get'],
]);

Такой подход упрощает поддержку версионирования API.

Использование анонимных функций как обработчиков

Для быстрых прототипов удобно назначать замыкания.

Пример

$routes = [
    '/' => function() { return 'Главная'; },
    '/time' => function() { return date('Y-m-d H:i:s'); },
];
$handler = $routes[$uri] ?? null;
if ($handler) {
    echo $handler();
} else {
    http_response_code(404);
}

Запрос /time -> '2025-04-10 15:30:00'

Маршрут index.php - comments

Index php route (php)