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