Разработка системы управления переводами (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+ проектах локализации. Получите консультацию и узнайте, как автоматизация сэкономит ваш бюджет.