Управление индексным файлом PHP при администрировании веб-сервера

Расширенные примеры настройки индексных файлов PHP

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

Пример 1. Apache: несколько индексных файлов с FallbackResource

Конфигурация для одностраничного приложения на PHP, где все запросы передаются на index.php, но при этом сохраняется возможность хранения статических файлов:

# /etc/apache2/sites-available/example.conf
<VirtualHost *:80>
    ServerName example.com
    DocumentRoot /var/www/example/public

    <Directory /var/www/example/public>
        Options -Indexes +FollowSymLinks
        DirectoryIndex index.php
        FallbackResource /index.php
    </Directory>
</VirtualHost>

Результат: при запросе http://example.com/nonexistent сервер отдаёт содержимое index.php, а URL остаётся прежним. Запросы к существующим файлам (например, /style.css) обслуживаются напрямую.

Пример 2. Nginx: маршрутизация через index.php с обработкой статики

server {
    listen 80;
    root /var/www/project/public;
    index index.php;

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

    location ~ \.php$ {
        fastcgi_pass unix:/var/run/php/php8.1-fpm.sock;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        include fastcgi_params;
    }
}

Результат: все запросы, не соответствующие существующему файлу или каталогу, перенаправляются на index.php. Статические файлы (изображения, CSS) отдаются напрямую, так как try_files проверяет их существование.

Пример 3. Встроенный PHP-сервер с пользовательским индексным файлом и роутером

# Создаём файл router.php
<?php
// Простой роутер для встроенного сервера
$uri = $_SERVER['REQUEST_URI'];
if (file_exists(__DIR__ . '/public' . $uri)) {
    return false; // отдаём статический файл
}
require __DIR__ . '/public/index.php';
?>

# Запуск сервера
php -S localhost:8080 -t public router.php

Результат: при запросе localhost:8080 сервер обращается к index.php (указан по умолчанию). При запросе /style.css - отдаёт файл из папки public. Если файла нет, срабатывает роутер.

Пример 4. IIS: настройка индексного документа через web.config

<?xml version="1.0" encoding="UTF-8"?>
<configuration>
    <system.webServer>
        <defaultDocument>
            <files>
                <add value="start.php" />
                <remove value="index.html" />
            </files>
        </defaultDocument>
    </system.webServer>
</configuration>

Результат: при обращении к каталогу IIS первым загружает start.php. Если его нет, сервер не будет искать index.html, так как он удалён из списка. Это полезно для приложений, где точка входа отличается от стандартной.

Пример 5. Использование .htaccess для перенаправления на index.php с исключением папок

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

Результат: все несуществующие файлы и каталоги направляются на index.php, а существующие (например, uploads/file.pdf) отдаются напрямую. Этот подход часто применяется в CMS.

Пример 6. Apache: динамический выбор индексного файла в зависимости от языка

# .htaccess в корне сайта
SetEnvIf Host ^fr\.example\.com$ LANG=fr
DirectoryIndex index_%{ENV:LANG}.php index.php

Результат: для поддомена fr.example.com сервер попытается загрузить index_fr.php, если он существует, иначе - стандартный index.php. Это упрощает мультиязычные сайты без дополнительных скриптов.

Пример 7. Nginx: индексный файл для каждого location отдельно

server {
    root /var/www/site;
    location / {
        index index.php;
    }
    location /admin/ {
        index admin.php;
    }
    location /api/ {
        index api.php;
    }
}

Результат: при запросе http://example.com/admin/ загружается admin.php, а при запросе / - index.php. Это позволяет чётко разделить функциональные блоки.