Организация единой точки входа с помощью index.php в Apache

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

Пример 1: Исключение статических директорий из редиректа

Нередко требуется, чтобы пути к стилям, скриптам или изображениям не попадали на index.php. Правила mod_rewrite можно дополнить условием, исключающим определённые префиксы.

RewriteEngine On
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteCond %{REQUEST_URI} !^/(css|js|images|uploads)/
RewriteRule ^ index.php [L]

Результат: при запросе /css/style.css файл отдаётся напрямую (если существует), при запросе /page/about/index.php обрабатывает запрос. Условие не требуется, если файлы существуют – проверка !-f уже отлавливает их. Данный пример явно демонстрирует, как запретить перезапись для указанных префиксов, даже если файл не существует (например, чтобы отдавать 404 для несуществующего пути в /css/).

Пример 2: Использование FallbackResource с передачей пути через переменную окружения

Директива FallbackResource не умеет передавать исходный URL. Однако можно комбинировать её с mod_rewrite или использовать переменную окружения в PHP. Например, с помощью mod_rewrite можно задать условие, которое будет работать совместно.

# Включить FallbackResource, а затем перезаписать, чтобы сохранить REQUEST_URI
FallbackResource /index.php
RewriteEngine On
RewriteRule ^ - [E=ORIG_PATH:%{REQUEST_URI}]

Результат: при любом запросе в PHP-переменную $_SERVER['REDIRECT_ORIG_PATH'] или $_SERVER['ORIG_PATH'] (в зависимости от настроек) будет помещён исходный URI, который можно использовать для маршрутизации. Однако следует учитывать, что FallbackResource уже перенаправил запрос на index.php, и последующее RewriteRule только устанавливает переменную, но не меняет обработку.

Пример 3: Перенаправление (редирект) со сложными условиями через mod_rewrite

Если требуется выполнить редирект клиента на index.php с сохранением параметров и передачей исходного пути как аргумента, можно использовать следующий шаблон.

RewriteEngine On
RewriteCond %{REQUEST_URI} !^/index\.php
RewriteCond %{HTTP_HOST} ^example\.com$ [NC]
RewriteRule ^(.*)$ /index.php?route=$1 [R=301, QSA, L]

Результат: запрос http://example.com/user/profile?lang=ru превратится в http://example.com/index.php?route=user/profile&lang=ru. Флаг QSA добавляет оригинальные параметры запроса. Такой редирект подходит, если нужно, чтобы все URL вели на index.php с явным указанием маршрута.

Пример 4: Использование PHP для внутреннего редиректа с сохранением статуса HTTP

Внутри index.php можно анализировать запрос и в зависимости от условий выполнять редирект с нужным кодом или перенаправлять на другой контроллер с помощью include. Пример обработки маршрута.

<?php
$request = parse_url($_SERVER['REQUEST_URI'], PHP_URL_PATH);
switch ($request) {
    case '/':
        include 'home.php';
        break;
    case '/contact':
        include 'contact.php';
        break;
    default:
        // если маршрут не найден, можно либо отдать 404, либо сделать редирект
        header('Location: /', true, 404);
        exit;
}
?>

Результат: при запросе /contact будет включён файл contact.php. Если путь неизвестен, произойдёт редирект на корень с кодом 404 (браузер увидит новый адрес). В реальном фреймворке вместо include обычно используются контроллеры и роутинг.

Пример 5: Настройка редиректа на index.php в зависимости от протокола (HTTPS)

Иногда требуется, чтобы все запросы на HTTP перенаправлялись на HTTPS, но при этом шли через index.php. Возможно объединение правил.

RewriteEngine On
RewriteCond %{HTTPS} off
RewriteRule ^(.*)$ https://%{HTTP_HOST}/index.php?route=$1 [R=301, QSA, L]
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule ^ index.php [L]

Результат: при обращении по HTTP произойдёт редирект на HTTPS с передачей маршрута. Если запрос уже по HTTPS, то сработает обычная перезапись на index.php (второе правило). Обратите внимание на порядок правил – редирект на HTTPS должен выполняться первым.

Пример 6: Команды для активации модуля и проверки конфигурации

Для работы с mod_rewrite требуются некоторые команды сервера (в Debian/Ubuntu).

sudo a2enmod rewrite
sudo systemctl restart apache2
# проверка синтаксиса конфигурации
sudo apache2ctl configtest

Результат: модуль активируется, Apache перезагружается. При успешной проверке конфигурации будет выведено "Syntax OK". Если возникают ошибки, необходимо исправить файлы конфигурации.

Пример 7: Использование RewriteMap для динамических редиректов через внешнюю программу

Если нужно часто менять правила редиректов (например, список старых URL), можно применить RewriteMap вместе с программой или файлом. Но это сложный сценарий; покажем кратко.

# В конфигурации сервера (не в .htaccess) объявляется карта
RewriteMap redirects txt:/etc/apache2/redirects.txt
# В .htaccess или VirtualHost правило:
RewriteCond ${redirects:%{REQUEST_URI}|NOT_FOUND} !NOT_FOUND
RewriteRule ^ /index.php?target=${redirects:%{REQUEST_URI}} [R=302,L]

Результат: файл redirects.txt содержит пары "старый URL новый URL". При совпадении запроса отправляется редирект на index.php с параметром target, содержащим новый URL. Это позволяет управлять редиректами без редактирования конфигурации Apache.