Реализация мультиязычности (i18n) сайта под ключ

Отметим: когда клиент решил выйти на международный рынок, его Laravel-магазин на русском начал терять позиции: Google показывал английским пользователям русские страницы, а дубли контента привели к падению трафика на 40% за месяц. Переписывать архитектуру пришлось с нуля — типичная ошибка при старте без i18n. Таких затрат можно избежать, если заложить интернационализацию с первого коммита. Наш опыт показывает: правильная архитектура окупается в первые три месяца. Например, один из проектов интернет-магазина бытовой техники после внедрения мультиязычности на 4 языка увеличил международный трафик на 70%, а средняя конверсия выросла на 15% за счёт адаптированных описаний товаров, что принесло дополнительную выручку в $50,000 за квартал. Ещё один клиент сэкономил $2,000 на исправлении дублей после правильной настройки hreflang.

i18n — это не просто перевод интерфейса. Это архитектура URL, хранение контента, SEO-разметка, кеширование, деплой. Ошибка на старте обходится в 3–5 раз дороже, чем правильная реализация сразу. Инженеры с профильным опытом решали подобные задачи для 20+ проектов e-commerce и SaaS. Гарантируем корректную работу на всех этапах: от выбора стратегии URL до финального деплоя с кешированием переводов в Redis. По данным официальной документации Laravel, использование пакета Astrotomic Translatable значительно упрощает мультиязычные модели.

Выбор стратегии URL для мультиязычности

Существует три основных подхода к организации URL мультиязычного сайта:

Путь (/ru/, /en/) — самый распространённый и простой в реализации. Поддомен лучше для географически разделённых аудиторий. Выбор зависит от требований проекта, но путь — оптимальный старт.

Почему hreflang важен для SEO?

Без hreflang поисковики могут показать пользователю неверную языковую версию или посчитать страницы дубликатами. Правильная разметка — обязательное требование для мультиязычного SEO. Мы автоматически генерируем hreflang для всех страниц на основе маршрутов и локалей, включая x-default. Экономия бюджета на исправление дублей — до 50%. Неверное использование hreflang может привести к штрафам и потере бюджета до $500 в месяц на рекламе.

Архитектура бэкенда

На бэкенде используем пакет Astrotomic Translatable для Eloquent. Пример модели:

use Astrotomic\Translatable\Contracts\Translatable as TranslatableContract;
use Astrotomic\Translatable\Translatable;

class Product extends Model implements TranslatableContract
{
    use Translatable;

    public array $translatedAttributes = ['title', 'description', 'slug'];

    protected $fillable = ['price', 'sku', 'is_active'];
}

Маршрутизация с префиксом локали и middleware для установки локали:

Route::prefix('{locale}')
    ->where(['locale' => 'ru|en|de|fr|uk'])
    ->middleware('setLocale')
    ->group(function () {
        Route::get('/', [HomeController::class, 'index'])->name('home');
        Route::get('/catalog', [CatalogController::class, 'index'])->name('catalog');
        Route::get('/catalog/{slug}', [ProductController::class, 'show'])->name('product');
    });

Middleware SetLocale устанавливает локаль из маршрута, сессии или браузера.

Фронтенд с i18next

На фронтенде используем i18next с react-i18next. Для Vue-приложений используется vue-i18n с аналогичной архитектурой. Конфигурация:

import i18n from 'i18next';
import { initReactI18next } from 'react-i18next';
import HttpBackend from 'i18next-http-backend';
import LanguageDetector from 'i18next-browser-languagedetector';

i18n
  .use(HttpBackend)
  .use(LanguageDetector)
  .use(initReactI18next)
  .init({
    fallbackLng: 'ru',
    supportedLngs: ['ru', 'en', 'de', 'fr', 'uk'],
    ns: ['common', 'catalog', 'checkout'],
    defaultNS: 'common',
    backend: {
      loadPath: '/locales/{{lng}}/{{ns}}.json'
    },
    detection: {
      order: ['path', 'cookie', 'localStorage', 'navigator'],
      lookupFromPathIndex: 0
    },
    interpolation: {
      escapeValue: false
    },
  });

Файлы переводов лежат в public/locales/{lng}/{ns}.json.

SEO для мультиязычных сайтов

Генерируем hreflang теги для каждой страницы:

function hreflangTags(string $routeName, array $params = []): string {
    $locales = ['ru', 'en', 'de', 'fr', 'uk'];
    $tags = '';
    foreach ($locales as $locale) {
        $url = route($routeName, array_merge($params, ['locale' => $locale]));
        $tags .= "<link rel=\"alternate\" hreflang=\"{$locale}\" href=\"{$url}\" />\n";
    }
    $defaultUrl = route($routeName, array_merge($params, ['locale' => 'ru']));
    $tags .= "<link rel=\"alternate\" hreflang=\"x-default\" href=\"{$defaultUrl}\" />\n";
    return $tags;
}

Включаем альтернативы в sitemap.xml.

Как автоматизировать перевод контента?

Первичный перевод через Google Translate API:

$results = (new TranslateClient(['key' => $key]))->translateBatch($texts, [
    'source' => 'ru',
    'target' => $targetLang,
    'format' => 'html',
]);

Затем ручная вычитка. Файлы переводов кешируем в Redis с TTL 1 час, чтобы не читать JSON при каждом запросе. Для массового перевода товаров используем очередь в Laravel: диспатчим задание ProcessTranslation для каждой модели после сохранения. Это позволяет не блокировать запросы и масштабировать перевод на сотни тысяч записей.

// Cache translations for 1 hour
Cache::remember('translations.' . $locale, 3600, function () use ($locale) {
    return Translation::where('locale', $locale)->get();
});