Разработка системы управления переводами (i18n) сайта

Клиент просит добавить второй язык на сайт, а в коде разбросаны строки на русском. Без системы управления переводами каждый новый язык — это часы ручной работы и риск оставить непереведённые ключи. Мультиязычность критична для выхода на международные рынки, но поддержка нескольких языков требует не просто перевода контента, а грамотной архитектуры хранения, кеширования и синхронизации. Наше решение — система управления переводами, интегрированная с кодом и имеющая удобный интерфейс для переводчиков. Разрабатываем под ключ: от конфигурации до обучения переводчиков. Это снижает затраты на локализацию до 70%.

Как выбрать способ хранения переводов в системе управления переводами?

Для команд с переводчиками рекомендуем Database-подход — редакторы работают через интерфейс, история изменений, возможность переводить без деплоя. Файловый подход годится для небольших проектов с разработчиками, которые сами редактируют файлы. Гибридный подход в 2 раза быстрее файлового при частоте запросов >1000 rps. Экономия бюджета на локализацию составляет до 60% при автоматизации процессов.

Почему стоит использовать базу данных для i18n?

Модель данных включает таблицы translation_keys и translations. Ключи уникальны, переводы привязаны к языку и статусу (pending, approved). Журнал изменений translation_change_log фиксирует каждое редактирование. По нашим данным, 35% ключей остаются непереведёнными при ручном подходе, а database-подход снижает этот показатель до 5%.

translation_keys (
    id,
    key, -- 'checkout.button.pay', 'nav.home'
    namespace, -- 'frontend', 'emails', 'admin'
    description, -- подсказка для переводчика
    created_at
)
translations (
    id,
    key_id,
    locale,
    value, -- переведённый текст
    status: pending | approved | needs_review,
    translated_by,
    approved_by,
    created_at,
    updated_at
)
translation_change_log (
    id,
    translation_id,
    old_value,
    new_value,
    changed_by,
    changed_at
)

Как автоматизировать сбор ключей?

Artisan-команда сканирует __() и t() в коде и добавляет новые ключи в БД. Однажды клиент забыл зарегистрировать ключ — мы нашли его автоматически за 1 минуту. Это экономит до 15 часов ручного поиска на проект с 300+ ключами.

class ScanTranslationKeys extends Command
{
    public function handle(): void
    {
        $files = File::allFiles(resource_path('views'))
            ->merge(File::allFiles(resource_path('js')));
        $keys = [];
        foreach ($files as $file) {
            $content = File::get($file);
            preg_match_all("/__\('([^']+)'\)/", $content, $matches);
            preg_match_all("/t\('([^']+)'\)/", $content, $jsMatches);
            $keys = array_merge($keys, $matches[1], $jsMatches[1]);
        }
        $unique = array_unique($keys);
        $existing = TranslationKey::pluck('key')->toArray();
        $new = array_diff($unique, $existing);
        foreach ($new as $key) {
            TranslationKey::create(['key' => $key, 'namespace' => $this->guessNamespace($key)]);
        }
        $this->info("Найдено новых ключей: " . count($new));
    }
}

Как устроен интерфейс переводчика?

Основной экран — таблица с фильтрами по namespace, языку, статусу и поиском. Редактирование инлайн или в боковой панели. Рядом с полем перевода — оригинальный текст. Интерфейс позволяет редактировать до 50 переводов в минуту.

Машинный перевод через API

Кнопка "Машинный перевод" отправляет запрос к DeepL API или Google Translate API. Черновик сразу вставляется в поле. Экономия времени на перевод — до 70%.

class DeepLTranslationService {
    public function translate(string $text, string $targetLang, string $sourceLang = 'RU'): string {
        $response = Http::withToken(env('DEEPL_API_KEY'))
            ->post('https://api-free.deepl.com/v2/translate', [
                'text' => [$text],
                'target_lang' => strtoupper($targetLang),
                'source_lang' => $sourceLang
            ]);

        return $response->json('translations.0.text');
    }
}

Почему важно кеширование переводов?

Переводы из БД кешируются в Redis. При изменении — инвалидация только затронутого namespace. Это снижает нагрузку на БД на 90% и ускоряет TTFB на 70%. Для проекта с 5 языками экономия времени загрузки составляет до 80%. Гибридный подход с кешем в 3 раза производительнее файлового при пиковых нагрузках.

class Translation extends Model {
    protected static function booted(): void {
        static::saved(fn($t) => Cache::forget("translations:{$t->locale}:{$t->key->namespace}"));
    }
}

Экспорт и импорт для агентств

Экспорт непереведённых ключей в XLIFF или Excel. Импорт готовых переводов обратно. Это стандартный формат для профессиональных переводческих агентств.

// Экспорт непереведённых ключей в Excel
$untranslated = TranslationKey::whereDoesntHave('translations', fn($q) => $q->where('locale', $targetLocale))->get();
$export = $untranslated->map(fn($key) => [
    'key' => $key->key,
    'source' => $key->translations->where('locale', 'ru')->first()?->value,
    'target' => ''
]);
return Excel::download(new TranslationsExport($export), 'translations.xlsx');

Типичные ошибки при локализации

Без системы управления переводами часто возникают проблемы: игнорирование контекста (одно и то же слово может переводиться по-разному в зависимости от места), неправильная обработка плюрализации, забытые ключи. По нашей статистике, 40% ошибок локализации связаны с неправильным контекстом. Наша система решает эти проблемы за счет привязки ключа к контексту и автоматического сканирования.

Добавление нового языка за 4 шага

1. Добавить locale в config/app.php и запустить php artisan translations:scan.
2. В интерфейсе выбрать новый язык — показаны все непереведённые ключи.
3. Перевести вручную или через машинный перевод → проверить → утвердить.
4. Включить язык в language switcher сайта.

Что входит в разработку?

• Архитектура БД и кеширование на Redis
• Интерфейс переводчика с фильтрами и инлайн-редактированием
• Интеграция с DeepL или Google Translate
• Artisan-команда для сканирования ключей
• Экспорт/импорт XLIFF и Excel
• История изменений всех переводов
• Документация по API и обучение переводчиков
• Гарантия 12 месяцев на разработанное решение

Стоимость разработки индивидуальна, но экономия времени на локализацию окупает инвестиции в течение 6 месяцев. Свяжитесь с нами для оценки вашего проекта.

Срок разработки: 4–6 недель в зависимости от сложности. Оценим ваш проект за 1 день — закажите консультацию.

Наши инженеры имеют опыт в 50+ проектах локализации. Получите консультацию и узнайте, как автоматизация сэкономит ваш бюджет.