Voyager Relationships 的多语言翻译实现-php教程-PHP中文网

Voyager Relationships 的多语言翻译实现

聖光之護

发布： 2025-09-25 15:44:16

原创

660人浏览过

voyager relationships 的多语言翻译实现

在使用 Laravel Voyager 管理后台时，实现 relationships 的多语言翻译是一个常见的需求。本文将介绍如何在 Voyager 中正确配置和使用 Translatable trait，以确保在处理 belongsToMany 和 hasMany 等关系时，能够根据当前应用语言环境显示翻译后的数据。通过示例代码和详细步骤，帮助开发者解决关系数据无法翻译的问题，并提供一种在 Blade 模板中正确访问翻译后关系数据的方法。

模型配置：使用 Translatable trait

首先，确保你的模型使用了 TCG\Voyager\Traits\Translatable trait，并且正确定义了 $translatable 属性。这个属性是一个数组，包含了需要进行翻译的字段。

例如，对于 Process、WorkMachine 和 Product 模型，你的配置应该如下：

Process Model:

<?php

namespace App\Models;

use Illuminate\Database\Eloquent\Model;
use TCG\Voyager\Traits\Translatable;

class Process extends Model
{
    use Translatable;

    protected $translatable = ['name', 'meta_description', 'description'];

    public function get_workmachine() {
        return $this->belongsToMany(WorkMachine::class, 'process_workmachine');
    }

    public function get_products() {
        return $this->hasMany(Product::class, 'process_product');
    }
}

登录后复制

WorkMachine Model:

<?php

namespace App\Models;

use Illuminate\Database\Eloquent\Model;
use TCG\Voyager\Traits\Translatable;

class WorkMachine extends Model
{
    use Translatable;

    protected $translatable = ['name', 'meta_description', 'description'];
}

登录后复制

Product Model:

<?php

namespace App\Models;

use Illuminate\Database\Eloquent\Model;
use TCG\Voyager\Traits\Translatable;

class Product extends Model
{
    use Translatable;

    protected $translatable = ['name'];
}

登录后复制

控制器中的数据获取

在控制器中，你需要确保获取到的数据已经进行了翻译。可以直接在查询结果上调用 translate() 方法，并传入当前应用的 locale。

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

登录后复制

尝试使用 -youjiankuohaophpcnwith(['get_workmachine' => function ($query) { $query->withTranslation('de'); }]) 预加载翻译可能不会直接生效，因为关系本身可能没有被正确翻译。

ViiTor实时翻译

AI实时多语言翻译专家！强大的语音识别、AR翻译功能。

116

查看详情

Blade 模板中的正确用法

在 Blade 模板中，访问 relationship 时，需要对 relationship 的结果进行翻译。如果直接访问 relationship 返回的是一个集合或对象，你需要对集合中的每个元素或对象调用 translate() 方法。

错误示例：

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

登录后复制

正确示例：

@foreach($process->get_workmachine as $workmachine)
    {{ $workmachine->translate(app()->getLocale())->name }}
@endforeach

登录后复制

或者，如果需要将整个集合转换为 JSON，再在前端解析，也需要先对集合进行翻译：

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

登录后复制

解释:

$process->get_workmachine 返回的是 WorkMachine 模型的集合。
$workmachine->translate(app()->getLocale()) 对单个 WorkMachine 模型实例进行翻译，返回翻译后的实例。
->name 访问翻译后的 WorkMachine 模型的 name 属性。

注意事项

确保你的数据库中已经存在相应语言的翻译数据。
检查 config/voyager.php 中的 multilingual.enabled 是否设置为 true，以及 multilingual.default 是否设置为你的默认语言。
如果仍然无法正常显示翻译，尝试清除缓存：php artisan cache:clear 和 php artisan config:cache。
如果使用了自定义的 relationship 方法（如 get_workmachine()），请确保这些方法返回的是 Eloquent relationship 对象，而不是直接返回数据。