
本文档旨在解决在使用 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)
...
...
@endforeachWorkMachine 模型的属性可能不会被翻译。为了解决这个问题,需要修改 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 关系翻译的问题。这种方法可以确保关联模型的属性被正确翻译,从而提供更好的用户体验。在处理复杂的关系和翻译时,建议仔细检查模型的配置和数据库中的翻译数据,以确保一切正常工作。










