Автоматическая локализация: получение языка клиента в PHP

Расширенные примеры реализации

Ниже приведены полные, готовые к использованию примеры кода с пояснениями и выводами.

Пример 1. Функция разбора Accept-Language с приоритетом

Функция возвращает массив языков, отсортированный по убыванию q-фактора, или строку с наилучшим языком.

function parseAcceptLanguage($acceptLanguage = null, $asArray = false) {
    $acceptLanguage = $acceptLanguage ?? $_SERVER['HTTP_ACCEPT_LANGUAGE'] ?? '';
    $langs = [];
    // Разбиваем по запятой, удаляем пробелы
    $items = explode(',', $acceptLanguage);
    foreach ($items as $item) {
        $item = trim($item);
        if (preg_match('/([a-z]{1,8}(-[a-z]{1,8})?)(?:;q=([0-9\.]+))?/i', $item, $m)) {
            $lang = $m[1];
            $q = isset($m[3]) && $m[3] !== '' ? (float)$m[3] : 1.0;
            $langs[$lang] = $q;
        }
    }
    arsort($langs);
    return $asArray ? $langs : array_keys($langs)[0] ?? 'en';
}
// Пример использования
$accept = 'fr-CH, fr;q=0.9, en;q=0.8, de;q=0.7, *;q=0.5';
echo 'Лучший язык: ' . parseAcceptLanguage($accept) . "\n";
echo "Массив приоритетов:\n";
print_r(parseAcceptLanguage($accept, true));

Результат выполнения:

Лучший язык: fr-CH
Массив приоритетов:
Array
(
    [fr-CH] => 1
    [fr] => 0.9
    [en] => 0.8
    [de] => 0.7
    [*] => 0.5
)

Пример 2. Использование библиотеки willdurand/negotiation

Установка: composer require willdurand/negotiation. Библиотека предоставляет удобный парсер HTTP-заголовков.

use Negotiation\LanguageNegotiator;

$negotiator = new LanguageNegotiator();
$acceptLanguage = $_SERVER['HTTP_ACCEPT_LANGUAGE'] ?? 'en';
$priorities = ['en', 'ru', 'de', 'fr'];
$bestLang = $negotiator->getBest($acceptLanguage, $priorities);
if ($bestLang) {
    echo 'Выбранный язык: ' . $bestLang->getValue() . "\n";
    echo 'Качество: ' . $bestLang->getQuality() . "\n";
} else {
    echo 'Язык не определён, используется en';
}

Результат (для заголовка 'ru,en;q=0.9'):

Выбранный язык: ru
Качество: 1

Пример 3. JavaScript + PHP: определение языка и сохранение в cookie

Полный пример с отправкой языка при загрузке страницы.

<!-- HTML -->
<script>
document.addEventListener('DOMContentLoaded', function() {
    if (!document.cookie.includes('client_lang')) {
        var lang = navigator.language || navigator.userLanguage || 'en';
        var xhr = new XMLHttpRequest();
        xhr.open('POST', '/save-language.php', true);
        xhr.setRequestHeader('Content-Type', 'application/x-www-form-urlencoded');
        xhr.send('lang=' + encodeURIComponent(lang));
    }
});
</script>

<?php // save-language.php
if (isset($_POST['lang'])) {
    $lang = substr($_POST['lang'], 0, 5); // например 'en-US'
    setcookie('client_lang', $lang, time() + 86400 * 30, '/');
    $_COOKIE['client_lang'] = $lang;
    echo 'OK';
}
?>

После выполнения язык сохранится в cookie. При следующем запросе PHP может читать его:

$userLang = $_COOKIE['client_lang'] ?? 'en';
echo 'Язык из cookie: ' . $userLang;

Пример 4. Геолокация через MaxMind GeoLite2 (Composer)

Установка: composer require geoip2/geoip2. Скачайте базу GeoLite2-Country.mmdb с сайта MaxMind.

require_once 'vendor/autoload.php';
use GeoIp2\Database\Reader;

$countryLangMap = [
    'RU' => 'ru',
    'UA' => 'uk',
    'BY' => 'be',
    'DE' => 'de',
    'FR' => 'fr',
    'GB' => 'en',
    'US' => 'en',
    'IT' => 'it',
    'ES' => 'es',
];

try {
    $reader = new Reader('/var/data/GeoLite2-Country.mmdb');
    $record = $reader->country($_SERVER['REMOTE_ADDR']);
    $countryCode = $record->country->isoCode; // 'RU', 'DE' etc.
    $language = $countryLangMap[$countryCode] ?? 'en';
    echo "Страна: $countryCode, предполагаемый язык: $language";
} catch (Exception $e) {
    echo 'Ошибка GeoIP: ' . $e->getMessage();
}

Пример вывода для пользователя из России:

Страна: RU, предполагаемый язык: ru

Пример 5. Комбинированная функция определения языка

Функция проверяет в порядке приоритета: сессию, cookie, Accept-Language, GeoIP, язык по умолчанию.

function detectLanguage() {
    $default = 'en';
    // 1. Сессия
    if (isset($_SESSION['lang'])) {
        return $_SESSION['lang'];
    }
    // 2. Cookie
    if (isset($_COOKIE['lang'])) {
        $_SESSION['lang'] = $_COOKIE['lang'];
        return $_COOKIE['lang'];
    }
    // 3. Accept-Language
    $acceptLang = $_SERVER['HTTP_ACCEPT_LANGUAGE'] ?? '';
    $parsed = parseAcceptLanguage($acceptLang);
    if ($parsed && $parsed !== '*') {
        $lang2 = substr($parsed, 0, 2);
        if (in_array($lang2, ['ru', 'en', 'de', 'fr'])) {
            $_SESSION['lang'] = $lang2;
            setcookie('lang', $lang2, time()+86400*30, '/');
            return $lang2;
        }
    }
    // 4. GeoIP
    $geoLang = getLanguageByGeoIP(); // воображаемая функция
    if ($geoLang) {
        $_SESSION['lang'] = $geoLang;
        setcookie('lang', $geoLang, time()+86400*30, '/');
        return $geoLang;
    }
    // 5. По умолчанию
    return $default;
}

Результат: для пользователя с Accept-Language 'de,en;q=0.5' функция вернёт 'de' и запишет в сессию и cookie.