Voyager Admin 解决 Eloquent 翻译问题

本文档旨在解决在使用 TCG/Voyager 管理界面时，Eloquent 关系中的翻译问题。具体而言，当主模型使用 Translatable trait 并且成功翻译其自身属性，但其关联模型（例如 belongsToMany 或 hasMany 关系）的翻译未能生效时，本文档提供了一个可行的解决方案，并解释了如何在 Blade 模板中正确地处理这些关系的翻译。

Eloquent 关系翻译问题

在使用 Voyager 管理 Laravel 应用时，经常会遇到需要翻译模型及其关联模型的情况。Voyager 提供了 Translatable trait，可以方便地实现模型属性的翻译。然而，当涉及到 Eloquent 关系时，直接使用 ->with() 加载的关系可能不会自动进行翻译。

以下面的模型关系为例：

• Process 模型 belongsToMany WorkMachine 模型。
• Process 模型 hasMany Product 模型。

假设 Process、WorkMachine 和 Product 模型都使用了 Translatable trait，并且定义了需要翻译的属性。如果在 Controller 中使用 ->with() 加载关系，并且在 Blade 模板中直接访问这些关系，可能会发现 Process 模型的属性被正确翻译，但 WorkMachine 和 Product 模型的属性仍然是默认语言。

解决方案：在 Blade 模板中进行翻译

一个可行的解决方案是在 Blade 模板中显式地对关系进行翻译。具体来说，需要在使用关系数据之前，调用 translate(app()->getLocale()) 方法。

以下是一个示例：

假设在 Controller 中已经加载了 Process 模型及其 get_workmachine 关系：

$process = App\Models\Process::where('slug', $processSlug)
                    ->with('get_workmachine')
                    ->with('get_products')
                    ->firstOrFail()->translate(app()->getLocale());

在 Blade 模板中，如果直接使用以下代码：

@foreach(json_decode($process->get_workmachine) as $workmachine)
    ...
    ...
@endforeach

WorkMachine 模型的属性可能不会被翻译。为了解决这个问题，需要修改 Blade 模板代码如下：

@foreach(json_decode($process->get_workmachine->translate(app()->getLocale())) as $workmachine)
    ...
    ...
@endforeach

通过在 get_workmachine 关系上调用 translate(app()->getLocale()) 方法，可以确保 WorkMachine 模型的属性被正确翻译。

代码解释：

• $process->get_workmachine：获取 Process 模型的 get_workmachine 关系。
• ->translate(app()->getLocale())：对关系中的每个模型进行翻译，使用当前应用的语言环境。
• json_decode(): 将关系数据解码为 JSON 格式，以便在 Blade 模板中进行循环访问。
• @foreach(...) as $workmachine：循环遍历翻译后的 WorkMachine 模型。

注意事项

• 确保在 Process、WorkMachine 和 Product 模型中都使用了 Translatable trait，并且定义了 $translatable 属性，指定需要翻译的字段。
• 检查 config/voyager.php 配置文件中的 multilingual.enabled 选项是否设置为 true，以启用多语言支持。
• 确保数据库中存在对应语言的翻译数据。

总结

通过在 Blade 模板中显式地调用 translate(app()->getLocale()) 方法，可以解决 Voyager Admin 中 Eloquent 关系翻译的问题。这种方法可以确保关联模型的属性被正确翻译，从而提供更好的用户体验。在处理复杂的关系和翻译时，建议仔细检查模型的配置和数据库中的翻译数据，以确保一切正常工作。