Русскоязычные адреса: практические приемы PHP

Расширенные примеры работы с русскими URL

Пример 1: Полная функция транслитерации с нормализацией

Функция преобразует строку в латинский slug, пригодный для ЧПУ.

function slugify($text) {
    // транслитерация
    $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',
        'А' => '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'
    ];
    $text = strtr($text, $map);
    // приводим к нижнему регистру
    $text = mb_strtolower($text, 'UTF-8');
    // заменяем пробелы и прочие небуквенные символы на дефис
    $text = preg_replace('/[^a-z0-9-]/', '-', $text);
    // удаляем повторяющиеся дефисы
    $text = preg_replace('/-+/', '-', $text);
    // обрезаем дефисы по краям
    $text = trim($text, '-');
    return $text;
}

echo slugify('Привет! Как дела?'); // privet-kak-dela

Пример 2: Формирование URL с параметрами, содержащими кириллицу

Имитация отправки поискового запроса.

$base = 'https://api.example.com/search';
$params = [
    'query' => 'русский текст',
    'page' => 2,
    'lang' => 'ru'
];
$url = $base . '?' . http_build_query($params, '', '&', PHP_QUERY_RFC3986);
echo $url;
// https://api.example.com/search?query=%D1%80%D1%83%D1%81%D1%81%D0%BA%D0%B8%D0%B9%20%D1%82%D0%B5%D0%BA%D1%81%D1%82&page=2&lang=ru

Пример 3: Декодирование и обработка входящего URL в роутере

Предположим, фронт-контроллер получает URI с русскими символами (браузер автоматически кодирует).

$uri = $_SERVER['REQUEST_URI']; // /поиск?q=тест
// разбираем
$path = parse_url($uri, PHP_URL_PATH); // /поиск
$query = parse_url($uri, PHP_URL_QUERY); // q=тест
parse_str($query, $params);
// $params['q'] уже декодирован в 'тест'
var_dump($params);

array(1) {
  ["q"] => string(8) "тест"
}

Пример 4: Использование библиотеки transliterator (intl) для полной обработки

Показывает работу с разными правилами.

if (extension_loaded('intl')) {
    $strings = ['Москва', 'Санкт-Петербург', 'Нью-Йорк'];
    $rules = ['Russian-Latin/BGN', 'Russian-Latin/ALA-LC', 'Any-Latin; Latin-ASCII'];
    foreach ($rules as $rule) {
        $t = Transliterator::create($rule);
        echo "Rule: $rule\n";
        foreach ($strings as $s) {
            echo $s . ' -> ' . $t->transliterate($s) . "\n";
        }
        echo "\n";
    }
}

Rule: Russian-Latin/BGN
Москва -> Moskva
Санкт-Петербург -> Sankt-Peterburg
Нью-Йорк -> Nyu-York

Rule: Russian-Latin/ALA-LC
Москва -> Moskva
Санкт-Петербург -> Sankt-Peterburg
Нью-Йорк -> Niŭ-Iork

Rule: Any-Latin; Latin-ASCII
Москва -> Moskva
Санкт-Петербург -> Sankt-Peterburg
Нью-Йорк -> Nyu-Iork

Пример 5: Обработка ошибки двойного кодирования

Демонстрация того, как проверить и исправить.

$bad = '%D1%82%D0%B5%D0%BA%D1%81%D1%82'; // уже закодированный текст
echo 'Двойное кодирование: ' . rawurlencode($bad) . "\n";
$fixed = rawurldecode($bad);
echo 'После декодирования: ' . $fixed . "\n";
// Если входящая строка могла быть закодирована дважды, декодируем дважды:
$doubleEncoded = rawurlencode(rawurlencode('тест'));
echo 'Дважды закодировано: ' . $doubleEncoded . "\n";
$decodedOnce = rawurldecode($doubleEncoded);
echo 'После одного декодирования: ' . $decodedOnce . "\n";
$decodedTwice = rawurldecode($decodedOnce);
echo 'После двух декодирований: ' . $decodedTwice . "\n";

Двойное кодирование: %251%25D1%2582%25D0%25B5%25D0%25BA%25D1%2581%25D1%2582
После декодирования: текст
Дважды закодировано: %25D1%2582%25D0%25B5%25D1%2581%25D1%2582
После одного декодирования: %D1%82%D0%B5%D1%81%D1%82
После двух декодирований: тест