Клиент просит добавить второй язык на сайт, а в коде разбросаны строки на русском. Без системы управления переводами каждый новый язык — это часы ручной работы и риск оставить непереведённые ключи. Мультиязычность критична для выхода на международные рынки, но поддержка нескольких языков требует не просто перевода контента, а грамотной архитектуры хранения, кеширования и синхронизации. Наше решение — система управления переводами, интегрированная с кодом и имеющая удобный интерфейс для переводчиков. Разрабатываем под ключ: от конфигурации до обучения переводчиков. Это снижает затраты на локализацию до 70%.
Как выбрать способ хранения переводов в системе управления переводами?
| Критерий | Файловый подход | Database-подход | Гибридный |
|---|---|---|---|
| Редактирование | Требует доступа к файловой системе | Через UI | UI + fallback |
| История изменений | Нет | Есть | Есть |
| Перевод без деплоя | Нет | Да | Да |
| Скорость (кеш) | Нет кеша | Redis | Redis |
Для команд с переводчиками рекомендуем 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 переводов в минуту.
| Фильтры | Колонки |
|---|---|
| Namespace | Ключ |
| Язык | Оригинал (ru) |
| Статус | Текущий перевод |
| Поиск по ключу/тексту | Действие: редактировать |
Машинный перевод через 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 шага
- Добавить locale в
config/app.phpи запуститьphp artisan translations:scan. - В интерфейсе выбрать новый язык — показаны все непереведённые ключи.
- Перевести вручную или через машинный перевод → проверить → утвердить.
- Включить язык в language switcher сайта.
Что входит в разработку?
- Архитектура БД и кеширование на Redis
- Интерфейс переводчика с фильтрами и инлайн-редактированием
- Интеграция с DeepL или Google Translate
- Artisan-команда для сканирования ключей
- Экспорт/импорт XLIFF и Excel
- История изменений всех переводов
- Документация по API и обучение переводчиков
- Гарантия 12 месяцев на разработанное решение
Стоимость разработки индивидуальна, но экономия времени на локализацию окупает инвестиции в течение 6 месяцев. Свяжитесь с нами для оценки вашего проекта.
Срок разработки: 4–6 недель в зависимости от сложности. Оценим ваш проект за 1 день — закажите консультацию.
Наши инженеры имеют опыт в 50+ проектах локализации. Получите консультацию и узнайте, как автоматизация сэкономит ваш бюджет.