Дефисы в URL CodeIgniter

Дефисы в URL CodeIgniterот MY_Router до автороутинга CI4

Поисковики и люди любят адреса через дефис, а PHP не разрешает дефис в имени класса. Разбираем, как CodeIgniter сводит одно с другим в каждой версии.

Раздел
PHP
Стек
PHPCodeIgniter 3CodeIgniter 4
Уровень
Средний
Опубликовано
Обновлено
Чтение
7 мин
Коротко
  • В CI2 дефисы переводятся в подчёркивания через свой MY_Router.
  • В CI3 хватает одной строки: $route['translate_uri_dashes'] = TRUE.
  • В CI4 с улучшенным автороутингом дефисы превращаются в CamelCase.
  • Явные маршруты с дефисами работают в любой версии и надёжнее всего.
Как решаем
  1. Решите, нужен ли автороутинг или хватит явных маршрутов
  2. CI2: переопределите _set_request() в application/core/MY_Router.php
  3. CI3: включите translate_uri_dashes в config/routes.php
  4. CI4: включите $translateUriToCamelCase или задайте маршруты явно
  5. Закройте дубли адресов через 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
<?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
<?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
<?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\Routinghello-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, и непонятно, кто виноват, роутер или сам контроллер. Мы проверяем настройку по короткому списку.

  1. Откройте адрес с подчёркиваниями. Если он не работает, проблема не в дефисах, а в имени файла или класса контроллера.
  2. Проверьте регистр. В CI3 файл контроллера должен начинаться с заглавной буквы: Product_reviews.php. На Windows и macOS ошибка в регистре не видна, а на Linux-сервере даёт 404.
  3. Откройте дефисную форму. Если не открывается только она, флаг не включён или включён не в том файле: в CI3 это application/config/routes.php, а не config.php.
  4. В 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.

CI 3.0появился translate_uri_dashes
4.5.0добавлен $translateUriToCamelCase
4.6.0CamelCase-перевод включён по умолчанию

«Дефис нужен адресу, подчёркивание нужно PHP; роутер работает переводчиком между ними.»

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

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

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

Почему нельзя назвать класс контроллера с дефисом?
Дефис не входит в допустимые символы идентификатора PHP. Парсер прочитает Product-reviews как вычитание константы reviews из Product, поэтому фреймворк должен переводить дефисы в подчёркивания или CamelCase до поиска класса.
Влияет ли translate_uri_dashes на параметры URL?
Нет. В CodeIgniter 3 флаг переводит только сегменты, по которым ищутся контроллер и метод. Слаги и другие параметры доходят до метода в исходном виде, вместе с дефисами.
Что выбрать в CodeIgniter 4: автороутинг или явные маршруты?
Для большинства проектов явные маршруты. Они наглядны, позволяют ограничить HTTP-методы и навесить фильтры. Улучшенный автороутинг удобен для внутренних панелей, где контроллеров много и они однотипны.
Нужно ли редиректить старые адреса с подчёркиванием?
Да, если они уже проиндексированы или на них есть ссылки. Отдавайте 301 на дефисную форму и обновите карту сайта, иначе поисковик будет видеть два адреса с одинаковым содержимым.
Заметка обновлена 12 ноября 2026: код проверен на актуальных версиях, добавлены современные варианты.

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