Voyager 中关联模型的翻译问题及解决方案-php教程-PHP中文网

Voyager 中关联模型的翻译问题及解决方案

霞舞

发布： 2025-09-25 15:22:01

原创

775人浏览过

voyager 中关联模型的翻译问题及解决方案

本文档旨在解决在使用 TCG\Voyager 管理后台时，关联模型无法正确翻译的问题。我们将详细介绍如何在 Laravel 项目中，通过 Voyager 实现关联模型的翻译，并提供具体的代码示例和解决方案，帮助开发者轻松应对多语言环境下的数据展示需求。

问题描述

在使用 Voyager 管理后台进行多语言网站开发时，经常会遇到关联模型无法自动翻译的问题。例如，一个 Process 模型关联了 WorkMachine 和 Product 模型，尽管 Process 模型本身可以正确翻译，但其关联的 WorkMachine 和 Product 模型却无法根据当前应用语言环境进行翻译。

模型配置

首先，确保你的模型已经正确配置了 Translatable trait，并且定义了 $translatable 属性，指定需要翻译的字段。

<?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');
    }
}

登录后复制

<?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'];
}

登录后复制

<?php

namespace App\Models;

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

class Product extends Model
{
    use Translatable;

    protected $translatable = ['name'];
}

登录后复制

控制器处理

在控制器中，获取 Process 模型时，需要使用 translate() 方法来获取当前语言环境下的翻译。

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

登录后复制

视图层处理

关键在于视图层如何处理关联模型的翻译。直接在循环中使用 json_decode() 方法并不能触发翻译。

错误示例:

火山翻译

火山翻译，字节跳动旗下的机器翻译品牌，支持超过100种语种的免费在线翻译，并支持多种领域翻译

193

查看详情

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

登录后复制

正确示例:

需要在视图层对关联模型进行翻译。对于 belongsToMany 关系，需要对结果集进行翻译。

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

登录后复制

或者，如果需要传递整个翻译后的模型，可以这样处理：

@foreach($process->get_workmachine as $workmachine)
    @php
        $translatedWorkmachine = $workmachine->translate(app()->getLocale());
    @endphp
    {{ $translatedWorkmachine->name }}
    ...
@endforeach

登录后复制

对于 hasMany 关系，同样需要在循环中进行翻译。

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

登录后复制

注意事项

确保 WorkMachine 和 Product 模型中需要翻译的字段已经存在相应的翻译数据。
translate(app()-youjiankuohaophpcngetLocale()) 方法返回的是翻译后的模型实例，可以直接访问其属性。
如果在控制器中使用 with(['get_workmachine' => function ($query) { $query->withTranslation('de'); }]) 尝试预加载翻译，可能不会生效，因为 Voyager 的翻译机制可能需要显式调用 translate() 方法。
确保 app()->getLocale() 返回正确的当前语言环境。

总结

通过在视图层显式调用 translate(app()->getLocale()) 方法，可以解决 Voyager 中关联模型无法自动翻译的问题。这种方法确保了关联模型能够根据当前应用语言环境正确显示翻译后的内容，从而实现完整的多语言支持。记住，需要在每个需要翻译的关联模型实例上都调用 translate() 方法，才能保证翻译的正确性。

以上就是Voyager 中关联模型的翻译问题及解决方案的详细内容，更多请关注php中文网其它相关文章！

大家都在看：

php怎么调试接口微服务架构_php接口微服务拆分与通信调试方法如何下载php文件下载文件_获取php文件下载功能代码的方法怎么在PHP代码中实现图片上传功能_PHP图片上传功能实现与安全处理教程 PHP日志怎么管理_PHP日志管理策略及分析技巧。 php代码安全性怎么加固_php代码安全漏洞修复与防护优化教程