Как организовать маршрут index.php для URL с кириллицей в PHP

Расширенные примеры и нестандартные ситуации

Пример 1: Обработка многобайтовых сегментов с вложенностью

Часто требуется маршрут типа /категория/подкатегория/товар с кириллицей. Рассмотрим реализацию с помощью FastRoute с именованными группами и вложенными данными.

<?php
$dispatcher = FastRoute\simpleDispatcher(function(FastRoute\RouteCollector $r) {
    $r->addRoute('GET', '/категория/{cat}/подкатегория/{sub}/товар/{id:\d+}', 'product_handler');
});

// Допустим, URI: /категория/Электроника/подкатегория/Смартфоны/товар/42
$uri = rawurldecode('/категория/Электроника/подкатегория/Смартфоны/товар/42');
$routeInfo = $dispatcher->dispatch('GET', $uri);
if ($routeInfo[0] === FastRoute\Dispatcher::FOUND) {
    $vars = $routeInfo[2];
    // $vars = ['cat' => 'Электроника', 'sub' => 'Смартфоны', 'id' => '42']
    print_r($vars);
}

Array
(
    [cat] => Электроника
    [sub] => Смартфоны
    [id] => 42
)

Пояснение: Шаблоны с кириллическими литералами работают благодаря тому, что FastRoute преобразует их в регулярные выражения с флагом u. При этом rawurldecode обязателен.

Пример 2: Транслитерация URL как альтернатива кириллице

Некоторые разработчики предпочитают хранить URL в транслите, избегая проблем с кодировкой. Однако при желании можно автоматически преобразовывать входящий кириллический маршрут в транслит для поиска в базе.

<?php
// Функция транслитерации (упрощенная)
function transliterate(string $text): string {
    $map = [
        'а' => 'a', 'б' => 'b', 'в' => 'v', 'г' => 'g', 'д' => 'd',
        'е' => 'e', 'ё' => 'yo', 'ж' => 'zh', 'з' => 'z', 'и' => 'i',
        'й' => 'y', 'к' => 'k', 'л' => 'l', 'м' => 'm', 'н' => 'n',
        'о' => 'o', 'п' => 'p', 'р' => 'r', 'с' => 's', 'т' => 't',
        'у' => 'u', 'ф' => 'f', 'х' => 'kh', 'ц' => 'ts', 'ч' => 'ch',
        'ш' => 'sh', 'щ' => 'shch', 'ъ' => '', 'ы' => 'y', 'ь' => '',
        'э' => 'e', 'ю' => 'yu', 'я' => 'ya'
    ];
    return strtr(mb_strtolower($text), $map);
}

$input = 'Электроника-Смартфоны';
$translit = transliterate($input);
echo $translit;

elektronika-smartfony

Такой подход позволяет иметь ЧПУ на кириллице, а для поиска использовать транслитерированную версию. Проблема: транслитерация может быть неоднозначной (например, 'ь' и 'ъ').

Пример 3: Обработка query-параметров с русскими значениями

Иногда кириллица передается не в пути, а в строке запроса: /search?q=телефон. Здесь автоматическое декодирование происходит через $_GET, но стоит убедиться в кодировке.

<?php
header('Content-Type: text/html; charset=utf-8');

$query = $_SERVER['QUERY_STRING'];
parse_str($query, $params);
// $params['q'] уже декодировано, но может быть в UTF-8
$q = $_GET['q'] ?? '';
echo "Поисковый запрос: $q";

Результат: Поисковый запрос: телефон

Ошибка: Если форма отправлена в кодировке CP1251, данные могут быть искажены. Настройка AddDefaultCharset UTF-8 в Apache решит проблему.

Пример 4: Использование PATH_INFO вместо REQUEST_URI

На некоторых серверах (например, при настройках CGI) переменная PATH_INFO может содержать декодированный путь. Однако она не включает query string и не всегда доступна.

<?php
$path = $_SERVER['PATH_INFO'] ?? '/';
// $path уже может быть декодированным, проверим
if (mb_detect_encoding($path, 'UTF-8', true)) {
    echo "Путь: $path";
} else {
    // принудительно декодируем
    $path = rawurldecode($path);
}

Предостережение: Не все серверы устанавливают PATH_INFO. В этом случае лучше полагаться на REQUEST_URI с ручным декодированием.

Пример 5: Интеграция с фреймворками (Laravel, Symfony)

Крупные фреймворки уже решают проблему кириллицы. Например, в Laravel маршруты с UTF-8 работают «из коробки», если использовать Route::get('/категория/{slug}', ...). Но важно, чтобы веб-сервер не обрезал URL до ASCII. Конфигурация nginx должна включать:

location / {
    try_files $uri $uri/ /index.php?$query_string;
}

А в php.ini необходимо установить mbstring.internal_encoding = UTF-8.

Нестандартная ситуация: двойное кодирование

Некоторые пользователи или внешние системы могут дважды кодировать URL (например, %25D0%25BA). Для защиты можно рекурсивно декодировать, пока строка содержит процентные последовательности.

function deepUrlDecode(string $uri): string {
    $decoded = rawurldecode($uri);
    while ($decoded !== $uri) {
        $uri = $decoded;
        $decoded = rawurldecode($uri);
    }
    return $uri;
}

Используйте с осторожностью, чтобы не зациклиться на корректных данных.