Дефисы в URL CodeIgniterот MY_Router до автороутинга CI4
Поисковики и люди любят адреса через дефис, а PHP не разрешает дефис в имени класса. Разбираем, как CodeIgniter сводит одно с другим в каждой версии.
- Раздел
- PHP
- Стек
- PHPCodeIgniter 3CodeIgniter 4
- Уровень
- Средний
- Опубликовано
- Обновлено
- Чтение
- 7 мин
- В CI2 дефисы переводятся в подчёркивания через свой MY_Router.
- В CI3 хватает одной строки: $route['translate_uri_dashes'] = TRUE.
- В CI4 с улучшенным автороутингом дефисы превращаются в CamelCase.
- Явные маршруты с дефисами работают в любой версии и надёжнее всего.
- Решите, нужен ли автороутинг или хватит явных маршрутов
- CI2: переопределите _set_request() в application/core/MY_Router.php
- CI3: включите translate_uri_dashes в config/routes.php
- CI4: включите $translateUriToCamelCase или задайте маршруты явно
- Закройте дубли адресов через 301 или canonical
Откуда берётся проблема#
CodeIgniter исторически строит адрес из имени контроллера и метода: /news/archive вызывает News::archive(). Пока имена состоят из одного слова, всё хорошо. Как только появляется Product_reviews::latest_items(), адрес превращается в /product_reviews/latest_items.
Такой URL работает, но выглядит хуже, чем /product-reviews/latest-items. Переименовать класс в Product-reviews нельзя: дефис в идентификаторе PHP недопустим, парсер прочитает его как оператор вычитания. Значит, кто-то должен переводить дефисы из адреса в подчёркивания до того, как фреймворк начнёт искать файл контроллера.
Этим «кем-то» в CodeIgniter всегда был роутер. Разница между версиями только в том, сколько кода нужно написать самому. Если вы собираете маршрутизацию с нуля без фреймворка, общий принцип мы разбирали в заметке про роутер на 40 строк.
Есть и обратная сторона. Многие команды привыкли называть методы в стиле snake_case, потому что так их видно в адресе. Стоит роутеру научиться переводу, и имена в коде можно выбирать по стандартам кода, а адреса по требованиям SEO, не жертвуя ни тем, ни другим.
CodeIgniter 2: свой MY_Router#
Во второй версии готовой настройки не было. Зато фреймворк позволял расширять любой системный класс: файл с префиксом из $config['subclass_prefix'] (по умолчанию MY_) в каталоге application/core подхватывается вместо оригинала. Сегменты URI попадают в метод _set_request(), его и переопределяем.
<?php if ( ! defined('BASEPATH')) exit('No direct script access allowed');
// application/core/MY_Router.php
class MY_Router extends CI_Router
{
function _set_request($segments = array())
{
// первые два сегмента: контроллер и метод
for ($i = 0; $i < 2; $i++) {
if (isset($segments[$i])) {
$segments[$i] = str_replace('-', '_', $segments[$i]);
}
}
return parent::_set_request($segments);
}
}Что важно знать про этот приём:
- Меняются только контроллер и метод. Параметры вроде
/blog/post/my-first-postостаются как есть, и это правильно: слаг статьи должен дойти до метода с дефисами. - Если контроллеры лежат в подкаталогах, сегмент с каталогом идёт первым, и индексы сдвигаются. Для подкаталогов логику придётся дополнить.
_set_request()считался внутренним методом. При обновлении ядра его сигнатуру стоило перепроверять.
Почему не обойтись правилом в .htaccess, которое заменит дефисы на подчёркивания? Технически можно, но переписанный адрес увидит и сам CodeIgniter, и тогда в $this->uri окажется подчёркнутая форма, а слаги статей тоже лишатся дефисов. Перевод внутри роутера точечный: он трогает только те сегменты, по которым ищется класс.
CodeIgniter 3: одна строка в routes.php#
В третьей версии эту задачу встроили в роутер. В application/config/routes.php есть зарезервированный ключ:
<?php
// application/config/routes.php
$route['default_controller'] = 'welcome';
$route['404_override'] = '';
$route['translate_uri_dashes'] = TRUE;
// явный маршрут с дефисом работает независимо от флага
$route['about-us'] = 'pages/about_us';Флаг влияет только на автоматический поиск контроллера и метода по сегментам. Явные маршруты вы и так пишете как хотите: слева адрес с дефисами, справа путь к методу.
Один побочный эффект легко пропустить. После включения флага открываются оба адреса: /product-reviews и /product_reviews. Для поисковика это два URL с одинаковым содержимым. Мы обычно добавляем в шаблон <link rel="canonical"> с дефисной формой или делаем 301 со старой формы в хуке pre_controller.
Если правок в роутере не хочется вовсе, во второй версии работал и лобовой вариант: перечислить нужные адреса в routes.php явными правилами вида $route['product-reviews/(:any)'] = 'product_reviews/$1'. Для пары контроллеров это проще, чем расширять ядро. Для десятков правило быстро превращается в список, который забывают обновлять при добавлении нового метода.
CodeIgniter 4: явные маршруты и CamelCase#
В CI4 автороутинг выключен по умолчанию, и рекомендованный путь звучит просто: объявляйте маршруты явно. Дефисы тогда ничего не стоят.
<?php
// app/Config/Routes.php
use CodeIgniter\Router\RouteCollection;
/** @var RouteCollection $routes */
$routes->get('product-reviews', 'ProductReviews::index');
$routes->get('product-reviews/latest-items', 'ProductReviews::latestItems');
// для старого автороутинга (legacy) перевод дефисов включается так:
// $routes->setTranslateURIDashes(true);Если автороутинг всё же нужен, в CI4 есть два режима:
| Режим | Как включить перевод | Что получится |
|---|---|---|
| Legacy | $routes->setTranslateURIDashes(true) | дефис превращается в подчёркивание |
| Improved | $translateUriToCamelCase в Config\Routing | hello-controller/some-method вызывает HelloController::getSomeMethod() |
Улучшенный автороутинг включается флагом $autoRoutesImproved в Config\Feature и требует префикса HTTP-метода у методов контроллера: getIndex(), postCreate(). Опция $translateUriToCamelCase появилась в 4.5.0, а с 4.6.0 включена по умолчанию; когда она активна, $translateURIDashes игнорируется. Имена классов при этом остаются в привычном PSR-стиле, без подчёркиваний.
Учтите, что флаг глобальный. Включили его, и перевод работает для всех контроллеров приложения, в том числе для служебных, которые вы не планировали показывать по красивому адресу. Это не дыра в безопасности, ведь адреса с подчёркиваниями открывались и раньше, но при аудите маршрутов о нём стоит помнить.
Зачем вообще дефисы#
Аргумент не только эстетический. В рекомендациях Google по структуре URL прямо сказано: для разделения слов используйте дефисы, а не подчёркивания. Подчёркивание поисковик может воспринять как часть слова, и latest_items склеится в один токен.
Есть и бытовые причины. Подчёркнутая ссылка в письме или документе прячет символ _ под линией, и человек перепечатывает адрес с пробелом. Дефис виден всегда. Ещё одна деталь: адреса в нижнем регистре через дефис проще держать единообразными на всём сайте, включая статические страницы и слаги статей.
Если сайт уже живёт на подчёркиваниях, переход делайте аккуратно: новые ссылки ставьте на дефисную форму, старые отдавайте через 301, карту сайта обновите в том же релизе. Про другую типичную граблю CodeIgniter, с сессиями при AJAX, у нас есть отдельная заметка.
Отдельный случай составляют контроллеры в подкаталогах: app/Controllers/Admin/UserGroups.php. В режиме улучшенного автороутинга сегмент каталога тоже переводится, и адрес admin/user-groups найдёт нужный класс. В явных маршрутах пространство имён указывается прямо в обработчике: 'Admin\UserGroups::index', и никакой магии не требуется.
Как проверить, что всё работает#
Перевод дефисов ломается тихо: адрес отдаёт 404, и непонятно, кто виноват, роутер или сам контроллер. Мы проверяем настройку по короткому списку.
- Откройте адрес с подчёркиваниями. Если он не работает, проблема не в дефисах, а в имени файла или класса контроллера.
- Проверьте регистр. В CI3 файл контроллера должен начинаться с заглавной буквы:
Product_reviews.php. На Windows и macOS ошибка в регистре не видна, а на Linux-сервере даёт 404. - Откройте дефисную форму. Если не открывается только она, флаг не включён или включён не в том файле: в CI3 это
application/config/routes.php, а неconfig.php. - В CI4 запустите
php spark routes: команда покажет и явные маршруты, и то, во что раскрывается автороутинг.
Отдельно проверьте ссылки внутри приложения. Хелпер site_url() в CI3 не переводит подчёркивания в дефисы: что передали, то и получите. Если ссылки по сайту собираются из имён методов, их придётся поправить вручную или через собственный хелпер, который делает str_replace('_', '-', ...).
Последний шаг касается кеша. Если перед приложением стоит обратный прокси или CDN, старые ответы 404 по дефисным адресам могут жить там ещё какое-то время. После включения флага сбросьте кеш, прежде чем делать выводы.
Ещё одно наблюдение из практики: слова в адресе лучше выбирать по смыслу, а не копировать из имени класса. ProductReviews::latestItems не обязан жить по адресу /product-reviews/latest-items; иногда /reviews/new короче и понятнее. Явные маршруты дают эту свободу бесплатно, а автороутинг навсегда привязывает адрес к структуре кода.
Что изменилось к 2026 году#
Ветка CI2 давно не поддерживается, а CI3 живёт в режиме сопровождения. Для новых проектов берите CodeIgniter 4 и PHP 8.3 или новее. Практические выводы на сегодня:
- Явные маршруты в
app/Config/Routes.phpостаются самым предсказуемым вариантом: видно, какие адреса существуют, проще ставить фильтры и проверять методы HTTP. - Если включаете улучшенный автороутинг, переименуйте методы с префиксами HTTP-глаголов и проверьте, что CamelCase-перевод работает так, как вы ждёте; команда
php spark routesпокажет итоговую таблицу. - Legacy-автороутинг в CI4 считается небезопасным: он открывает любой публичный метод контроллера для любого HTTP-метода.
- Дубли адресов по-прежнему закрывайте 301-редиректом или canonical.
Больше заметок про фреймворк собрано в разделе CodeIgniter, общие приёмы на чистом языке ищите в разделе PHP.
«Дефис нужен адресу, подчёркивание нужно PHP; роутер работает переводчиком между ними.»
Главный вывод заметки


