Конфигурирование index.php в nginx: варианты и рекомендации

Расширенные примеры настройки index.php

Пример 1: Комбинированная конфигурация с двумя корнями и index.php

server {
    listen 80;
    server_name site.ru;

    # Основной корень для статики
    root /var/www/site/public;

    # Если запрошенная директория содержит index.php – отдаём его через PHP
    index index.php;

    # Все PHP-файлы обрабатываем через сокет
    location ~ \.php$ {
        fastcgi_pass unix:/run/php/php8.1-fpm.sock;
        fastcgi_param SCRIPT_FILENAME $realpath_root$fastcgi_script_name;
        include fastcgi_params;
    }

    # Для админ-панели отдельный корень и index.php
    location /admin {
        alias /var/www/admin/public;
        try_files $uri $uri/ /admin/index.php?$args;

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

Результат: при запросе /admin/ nginx ищет /var/www/admin/public/index.php (благодаря try_files внутри location /admin). alias и try_files в паре требуют внимания к пути fallback.

Пример 2: Использование map для динамического выбора index-файла

map $uri $index_file {
    ~^/old/  index.php;
    ~^/new/  index.html;
    default  index.php;
}

server {
    root /var/www;
    index $index_file;
    # ...
}

Здесь директива index принимает переменную. Если запрос начинается с /old/, индексом будет index.php; если с /new/ - index.html. Обратите внимание: такое использование менее производительно, но гибко.

Пример 3: Настройка index.php в конфигурации с HTTPS и фильтрацией запросов

server {
    listen 443 ssl http2;
    server_name example.ru;
    ssl_certificate /etc/ssl/certs/example.crt;
    ssl_certificate_key /etc/ssl/private/example.key;

    root /srv/example;
    index index.php;

    # Запрет доступа к скрытым файлам (включая index.php в особых папках)
    location ~ /\. {
        deny all;
        return 404;
    }

    # Основной location для PHP
    location ~ \.php$ {
        # Ограничить размер загружаемых файлов
        client_max_body_size 10M;
        try_files $uri =404;
        fastcgi_pass 127.0.0.1:9000;
        fastcgi_index index.php;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        include fastcgi_params;

        # Передача дополнительных параметров в PHP-скрипт
        fastcgi_param APPLICATION_ENV production;
    }

    # Статика отдаётся напрямую с кэшированием
    location ~* \.(css|js|png|jpg)$ {
        expires 30d;
        access_log off;
    }
}

Результат: при обращении к / nginx ищет /srv/example/index.php, и если файл найден, передаёт его PHP-FPM по TCP. Дополнительно настроена защита от доступа к .htaccess и подобным файлам.

Пример 4: Обработка ошибок с перенаправлением на index.php (кастомная страница 404)

server {
    root /var/www/site;
    index index.php;

    error_page 404 /index.php?error=404;

    location / {
        try_files $uri $uri/ /index.php$is_args$args;
    }

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

При возникновении 404 nginx выполняет внутренний редирект на /index.php?error=404. Сам index.php должен обрабатывать параметр error и отдавать соответствующий контент.

Пример 5: Отладка ошибок с index.php через логирование

http {
    log_format debug '$remote_addr $uri $status $request_time $upstream_response_time';
    access_log /var/log/nginx/debug.log debug;
}

server {
    index index.php;
    root /app;
    # ...
}

Проверка в логах: если запрос / возвращает 404, а должен 200, смотреть строку с $uri - возможно, nginx ищет не тот файл или не проходит FastCGI.

Пример 6: Нестандартное имя индексного файла (app.php)

server {
    index app.php;
    location / {
        try_files $uri $uri/ /app.php?$query_string;
    }
    location ~ \.php$ {
        fastcgi_pass 127.0.0.1:9000;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        include fastcgi_params;
    }
}

Здесь вместо index.php используется app.php. Все правила перенаправления и обработки PHP остаются теми же.