Laravel 数据库记录的自动化翻译实现方案-php教程-PHP中文网

Laravel 数据库记录的自动化翻译实现方案

本文介绍在 laravel 中结合 laravel-translatable 实现数据库内容自动翻译的三种可行路径：实时 api 翻译、种子阶段批量翻译，以及静态数据的手动维护策略，并提供可落地的代码示例与关键注意事项。

本文介绍在 laravel 中结合 laravel-translatable 实现数据库内容自动翻译的三种可行路径：实时 api 翻译、种子阶段批量翻译，以及静态数据的手动维护策略，并提供可落地的代码示例与关键注意事项。

在使用 astrotomic/laravel-translatable 时，「自动翻译」并非框架原生能力，而是需结合外部服务或预处理逻辑实现。核心在于区分数据性质：动态内容适合运行时调用翻译 API；静态内容（如食品名称、分类标签）更适合在 Seeder 中一次性调用翻译服务完成入库。直接依赖不同语言 Faker（如 en_US 和 hr_HR）生成“同义词”是不可靠的——Faker 的本地化数据不保证语义对齐（例如 food provider 在英文中返回 'pasta'，克罗地亚语中却可能返回 'pasta' 而非正确译文 'tjestenina'），本质上仍是独立随机生成，而非翻译。

✅ 推荐方案一：Seeder 阶段调用翻译 API（适用于静态/半静态数据）

以 Google Cloud Translation API 或免费替代方案（如 LibreTranslate）为例，在 Seeder 中批量翻译英文原始值：

// 在 Database\Seeders\MealSeeder.php 中
use Illuminate\Support\Facades\Http;

public function run()
{
    $en_faker = \Faker\Factory::create('en_US');

    for ($i = 0; $i unique()->food;
        $desc_en = $en_faker->text;

        // 调用翻译 API（示例：LibreTranslate 公共端点）
        $response = Http::asForm()->post('https://libretranslate.de/translate', [
            'q'     => $title_en,
            'source'=> 'en',
            'target'=> 'hr',
        ]);

        $title_hr = $response->successful() 
            ? $response->json('translatedText') 
            : '[TRANSLATION_FAILED]';

        // 同样处理 description（可选：合并翻译或分段调用）
        $desc_hr = Http::asForm()->post('https://libretranslate.de/translate', [
            'q'     => $desc_en,
            'source'=> 'en',
            'target'=> 'hr',
        ])->json('translatedText') ?? '[DESC_TRANSLATION_FAILED]';

        Meal::create([
            'category_id' => rand(1, 5),
            'status'      => 'created',
            'translations' => [
                ['locale' => 'en', 'title' => $title_en, 'description' => $desc_en],
                ['locale' => 'hr', 'title' => $title_hr, 'description' => $desc_hr],
            ],
        ]);
    }

    // 关联 tags & ingredients...
}

⚠️ 注意事项：

生产环境务必使用带认证的商用 API（如 Google Translate API）并配置配额与错误重试；

对长文本或大量数据，应添加 sleep() 或异步队列避免请求限频；

始终提供 fallback 值（如 [TRANSLATION_FAILED]），防止空字段破坏 translatable 行为；

翻译结果建议人工抽检校验，尤其涉及专业术语（如食品名、医学词汇）。

✅ 推荐方案二：运行时按需翻译（适用于动态/用户生成内容）

若内容高频更新或需多语言实时切换，可绕过数据库存储译文，改由前端或 API 层动态调用：

Laravel Cloud

Laravel Cloud（cloud.laravel.com）。此技能用于处理所有 Laravel Cloud 请求，包括搜索和读取数据。只要任务涉及 Laravel Cloud，即使用此技能。

下载

// 在 MealController.php 中
public function show(Request $request, Meal $meal)
{
    $locale = $request->input('locale', app()->getLocale());
    $title = $locale === 'en' 
        ? $meal->getTranslation('title', 'en')
        : Http::asForm()->post('https://libretranslate.de/translate', [
            'q' => $meal->getTranslation('title', 'en'),
            'source' => 'en',
            'target' => $locale,
        ])->json('translatedText') ?? $meal->getTranslation('title', 'en');

    return response()->json(['title' => $title, 'description' => ...]);
}

此方式节省存储空间且保证译文最新，但增加响应延迟与第三方依赖风险，仅推荐用于低频、非核心字段或 PoC 验证场景。