Убираем 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.
- Включите переписывание: .htaccess в Apache или try_files в nginx
- Очистите index_page в CI3 или app.indexPage в .env для CI4
- Подберите uri_protocol, если все адреса открывают главную
- В CI4 направьте корень сайта на каталог public/
- Настройте 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.
# .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
// 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:
# вариант для хостингов с 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 для 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, не трогая файл в репозитории:
# .env в корне проекта CodeIgniter 4
app.baseURL = 'https://example.test/'
app.indexPage = ''Обратите внимание: baseURL в CodeIgniter 4 должен заканчиваться слэшем. Полный конфиг nginx для четвёртой версии с PHP-FPM выглядит так:
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, поэтому ему нужно разрешить работу.
<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 добавьте правило перед основным переписыванием:
# 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.
«Чистый URL в CodeIgniter складывается из двух половин: сервер прячет index.php, а фреймворк перестаёт его дописывать.»
Главный вывод заметки


