Убираем index.php из адресов

Убираем index.php из адресовApache, nginx и CodeIgniter от второй до четвёртой версии

Чистые адреса в CodeIgniter требуют двух правок: переписывания на сервере и пустого index_page в конфиге. Разбираем Apache, nginx, частые поломки и правильный корень сайта в CodeIgniter 4.

Раздел
CodeIgniter
Стек
CodeIgniterApachenginxPHP
Уровень
Новичок
Опубликовано
Обновлено
Чтение
7 мин
Коротко
  • Нужны обе половины: rewrite на сервере и пустой index_page.
  • Условия !-f и !-d спасают стили и картинки от 404.
  • В CodeIgniter 4 корнем сайта должен быть каталог public/.
  • Старые адреса с index.php переводите одним 301.
Как решаем
  1. Включите переписывание: .htaccess в Apache или try_files в nginx
  2. Очистите index_page в CI3 или app.indexPage в .env для CI4
  3. Подберите uri_protocol, если все адреса открывают главную
  4. В CI4 направьте корень сайта на каталог public/
  5. Настройте 301 со старых адресов /index.php/...

Откуда берётся index.php в адресе#

CodeIgniter построен вокруг одного фронт-контроллера: любой запрос попадает в index.php, а уже он по остатку пути выбирает контроллер и метод. Без настройки сервера адрес страницы выглядит как /index.php/blog/post/42. Это работает везде, где PHP умеет передавать скрипту хвост пути, но выглядит неаккуратно, мешает аналитике и даёт поисковикам два адреса одной страницы.

Чтобы убрать index.php, нужно две вещи: веб-сервер должен незаметно переписывать чистый адрес на фронт-контроллер, а фреймворк перестать добавлять index.php в генерируемые ссылки. Если пропустить одну из половин, получите либо 404 на всех страницах, кроме главной, либо ссылки, которые по-прежнему ведут на старые адреса. Как устроена маршрутизация под капотом, мы показывали в заметке про простой роутер на PHP.

Apache и .htaccess в CodeIgniter 2 и 3#

Классическое решение для Apache: файл .htaccess рядом с index.php. Два условия RewriteCond пропускают существующие файлы и каталоги, иначе стили, скрипты и картинки тоже уйдут во фреймворк и вернут 404 от CodeIgniter.

nginx
# .htaccess в корне проекта CodeIgniter 2/3
<IfModule mod_rewrite.c>
    RewriteEngine On
    # RewriteBase /myapp/    # если сайт лежит в подкаталоге

    # реальные файлы и каталоги (css, js, картинки) отдаём как есть
    RewriteCond %{REQUEST_FILENAME} !-f
    RewriteCond %{REQUEST_FILENAME} !-d

    # всё остальное через фронт-контроллер
    RewriteRule ^(.*)$ index.php/$1 [L]
</IfModule>

Вторая половина в конфиге приложения:

PHP
<?php
// application/config/config.php (CodeIgniter 3)
$config['base_url']     = 'https://example.test/';
$config['index_page']   = '';            // было 'index.php'
$config['uri_protocol'] = 'REQUEST_URI'; // при сбоях: 'QUERY_STRING' или 'PATH_INFO'

Параметр uri_protocol говорит фреймворку, из какой серверной переменной брать путь. В CodeIgniter 2 по умолчанию стояло AUTO, и фреймворк перебирал варианты сам; в третьей версии значение по умолчанию REQUEST_URI, а AUTO убрали. Если после настройки любой адрес открывает главную страницу, почти всегда виноват именно этот параметр.

На части хостингов PHP работает через CGI или FastCGI и не получает хвост пути. Симптом: сообщение «No input file specified». Тогда передайте путь через строку запроса и выставьте uri_protocol в QUERY_STRING:

nginx
# вариант для хостингов с PHP в режиме CGI/FastCGI
RewriteRule ^(.*)$ index.php?/$1 [L]

Если не работает: короткая диагностика#

СимптомВероятная причина
404 Apache на всех страницах, кроме главнойНе включён mod_rewrite или для каталога стоит AllowOverride None, и .htaccess игнорируется
Любой адрес показывает главную страницуНеподходящий uri_protocol
«No input file specified»PHP в режиме CGI, нужен вариант с index.php?/$1
Стили и скрипты отдают 404Нет условий !-f и !-d или ассеты лежат вне корня сайта
В ссылках по-прежнему есть index.phpНе очищен index_page
Работает только в корне, но не в подкаталогеНе задан RewriteBase или base_url

Проверять удобнее не браузером, а из консоли: curl -I показывает код ответа и заголовок Location без кэша и без автоматических переходов.

Отдельная история с подкаталогами. Если приложение открывается по адресу /shop/, а не в корне домена, в .htaccess нужен RewriteBase /shop/, а base_url должен включать этот подкаталог. Иначе правило переписывания будет искать index.php в корне домена, и вы получите либо чужой сайт, либо 404. Ещё одна частая ошибка: два приложения в соседних подкаталогах с одним общим .htaccess на уровень выше. Правила наследуются, и запросы второго приложения уходят в первое. Держите у каждого приложения свой файл с правилами и проверяйте адреса обоих после любой правки. Общие советы по настройке PHP-окружения, которые пригодятся и здесь, лежат в разделе PHP.

nginx: try_files вместо .htaccess#

nginx не читает .htaccess, правила пишутся в конфиг сервера. Для CodeIgniter 3 хватает одной директивы: try_files пробует отдать файл, затем каталог, а если не нашлось ни того, ни другого, передаёт запрос фронт-контроллеру.

nginx
# nginx для CodeIgniter 3: корень сайта = каталог с index.php
location / {
    try_files $uri $uri/ /index.php?/$request_uri;
}

Форма с ?/ соответствует варианту QUERY_STRING из предыдущего раздела. Если в конфиге приложения оставлен REQUEST_URI, можно писать короче: /index.php$is_args$args, фреймворк сам разберёт исходный путь из заголовка запроса.

Есть важная разница с Apache, о которой забывают при переезде. В дистрибутиве CodeIgniter 3 каталоги application/ и system/ защищены собственными файлами .htaccess с запретом доступа. nginx эти файлы не читает, и если весь проект лежит в корне сайта, конфиги и логи становятся доступны по прямой ссылке. Закройте их явно, например блоком location ~ ^/(application|system)/ { deny all; }, и проверьте через curl -I, что в ответ приходит 403.

Что изменилось к 2026 году#

В CodeIgniter 4 поменялась сама структура проекта. Фронт-контроллер переехал в каталог public/, а код приложения, конфиги, .env и vendor/ лежат уровнем выше и не должны быть доступны из веба. Поэтому главное правило звучит так: корнем сайта (DocumentRoot в Apache, root в nginx) должен быть именно public/. Готовый .htaccess для Apache уже лежит в этом каталоге в стандартной установке.

Добавлять index.php в ссылки по-прежнему управляет конфиг, только теперь это свойство Config\App::$indexPage. Удобнее переопределить его в .env, не трогая файл в репозитории:

Shell
# .env в корне проекта CodeIgniter 4
app.baseURL   = 'https://example.test/'
app.indexPage = ''

Обратите внимание: baseURL в CodeIgniter 4 должен заканчиваться слэшем. Полный конфиг nginx для четвёртой версии с PHP-FPM выглядит так:

nginx
server {
    listen 443 ssl;
    server_name example.test;

    # корень сайта: только public/, код приложения снаружи
    root  /var/www/example/public;
    index index.php;

    # старые адреса с index.php склеиваем постоянным редиректом
    location ~ ^/index\.php/(.*)$ {
        return 301 /$1$is_args$args;
    }

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

    location ~ \.php$ {
        include snippets/fastcgi-php.conf;
        fastcgi_pass unix:/run/php/php8.3-fpm.sock;
    }

    location ~ /\. {
        deny all;
    }
}

Что поменялось по сравнению с эпохой CodeIgniter 2 и 3:

  • Корень сайта. Раньше весь проект лежал в вебе, а application/ и system/ закрывались отдельными .htaccess. Теперь наружу смотрит только public/.
  • Настройка. Вместо правки config.php значения задаются в .env для каждого окружения.
  • Локальная разработка. Команда php spark serve поднимает встроенный сервер, которому переписывание адресов вообще не нужно.
  • Чистые адреса по умолчанию. Свежий проект с правильным корнем работает без index.php почти сразу, остаётся очистить indexPage.

Для Apache в четвёртой версии меняется только виртуальный хост: корень указывает на public/, а переписывание делает поставляемый .htaccess, поэтому ему нужно разрешить работу.

nginx
<VirtualHost *:443>
    ServerName example.test
    DocumentRoot /var/www/example/public

    <Directory /var/www/example/public>
        AllowOverride All
        Require all granted
    </Directory>
</VirtualHost>

Права на каталоги тоже стоит пересмотреть: веб-серверу нужна запись только в writable/ (кэш, логи, сессии), всё остальное достаточно сделать доступным на чтение.

Редирект со старых адресов#

Если сайт годами жил с index.php в URL, эти адреса уже проиндексированы и разошлись по ссылкам. Оставлять их отвечающими 200 нельзя: получится дубль каждой страницы. Нужен постоянный редирект на чистый адрес. В nginx он есть в конфиге выше, для Apache добавьте правило перед основным переписыванием:

nginx
# Apache: 301 со старых адресов /index.php/... на чистые
RewriteCond %{THE_REQUEST} \s/index\.php/([^\s?]*) [NC]
RewriteRule ^ /%1 [R=301,L]

Условие смотрит на THE_REQUEST, то есть на исходную строку запроса от браузера. Это важно: если проверять обычный путь, правило сработает и на внутреннем переписывании, которое само добавляет index.php, и вы получите бесконечный цикл редиректов. Строка запроса после знака вопроса сохранится автоматически. Если параллельно приводите адреса к единому виду, например заменяете подчёркивания дефисами, сделайте это одним редиректом, как в заметке про дефисы в URL CodeIgniter, чтобы не строить цепочки из нескольких 301.

После выкладки пройдитесь по старым адресам через curl -I и убедитесь, что каждый отвечает одним 301 на конечный адрес, а он уже 200. Другие практические заметки по фреймворку собраны в разделе CodeIgniter.

2правки: сервер и конфиг приложения
public/корень сайта в CodeIgniter 4
301код редиректа со старых адресов

«Чистый URL в CodeIgniter складывается из двух половин: сервер прячет index.php, а фреймворк перестаёт его дописывать.»

Главный вывод заметки

Вопросы и ответы

Вопросы и ответы

Почему после настройки .htaccess все страницы, кроме главной, отдают 404?
Скорее всего, Apache не читает .htaccess: для каталога выставлено AllowOverride None или не включён модуль mod_rewrite. Проверьте конфиг виртуального хоста и список загруженных модулей, затем перезапустите Apache и повторите запрос через curl -I.
Что выбрать в uri_protocol для CodeIgniter 3?
Начните со значения по умолчанию REQUEST_URI, оно подходит большинству серверов. Если любой адрес открывает главную или PHP работает через CGI, переключитесь на QUERY_STRING и передавайте путь как index.php?/$1. PATH_INFO нужен редко.
Можно ли в CodeIgniter 4 оставить корень сайта в корне проекта?
Технически можно переписывать запросы в public/ через дополнительный .htaccess, но это обходной путь для хостингов без выбора корня. Правильнее направить DocumentRoot или root в nginx на public/, тогда .env, конфиги и vendor/ не будут доступны из веба.
Нужно ли перенаправлять старые адреса с index.php?
Да, если они уже были в поиске или в ссылках. Без редиректа каждая страница будет доступна по двум адресам. Постоянный 301 на чистый адрес склеивает дубли, а проверка по THE_REQUEST в Apache защищает от зацикливания.
Заметка обновлена 12 ноября 2026: код проверен на актуальных версиях, добавлены современные варианты.

Читайте также