Voyager项目多语言功能实现详解-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_00403/article/details/148393555

Voyager项目多语言功能实现详解

voyager thedevdojo/voyager: 是一个基于 Laravel 框架的后台管理系统，支持多种数据源和插件扩展。该项目提供了一个简单易用的后台管理系统，可以方便地实现数据的查询和管理，同时支持多种数据库和插件扩展。项目地址: https://gitcode.com/gh_mirrors/vo/voyager

前言

在现代Web应用开发中，多语言支持已成为基本需求。Voyager作为一款优秀的后台管理系统，提供了完善的多语言解决方案。本文将深入解析Voyager的多语言功能实现原理和使用方法。

多语言配置

基础配置

启用Voyager的多语言功能需要在配置文件中进行简单设置：

'multilingual' => [
    'enabled' => true,       // 启用多语言功能
    'default' => 'en',       // 设置默认语言
    'locales' => [           // 配置支持的语言列表
        'en',
        'da',
    ],
],

模型配置

要使模型支持多语言，需要完成以下两步：

引入Translatable Trait
定义可翻译字段

use TCG\Voyager\Traits\Translatable;

class Post extends Model
{
    use Translatable;
    protected $translatable = ['title', 'body']; // 指定可翻译字段
}

配置完成后，在后台管理界面中会自动显示语言选择功能。

多语言数据操作

数据查询优化

Voyager提供了多种方式高效加载翻译数据：

// 方式1：预加载所有翻译
$posts = Post::with('translations')->get();

// 方式2：查询后加载翻译
$posts = Post::all();
$posts->load('translations');

// 方式3：使用快捷方法加载
$posts = Post::withTranslations()->get(); // 所有语言
$posts = Post::withTranslations(['en', 'da'])->get(); // 指定语言
$posts = Post::withTranslation('da')->get(); // 单一语言

数据读取方式

获取翻译数据有多种方法：

// 获取默认语言的值
echo $post->title;

// 获取指定语言的翻译值
echo $post->getTranslatedAttribute('title', 'da', 'en');

参数说明：

第一个参数：字段名
第二个参数(可选)：目标语言，默认使用当前应用语言
第三个参数(可选)：回退语言，默认使用应用回退语言，设为false可禁用回退

模型整体翻译

可以一次性翻译整个模型：

$post = $post->translate('da'); // 翻译为丹麦语
echo $post->title;

// 集合翻译
$posts = $posts->translate('da');
echo $posts[0]->title;

翻译状态检查

检查模型是否支持翻译：

// 通过类名检查
if (Voyager::translatable(Post::class)) {
    // 支持翻译
}

// 通过模型实例检查
if (Voyager::translatable($post)) {
    // 支持翻译
}

高级功能

翻译数据写入

更新或创建翻译数据：

$post = $post->translate('da');
$post->title = '新标题';
$post->save();

注意：如果修改的字段未标记为可翻译，修改将直接作用于默认语言模型。

翻译数据查询

Voyager提供了专门的翻译查询方法：

// 基本查询
$page = Page::whereTranslation('slug', '我的翻译slug');

// 指定运算符
$page = Page::whereTranslation('slug', '=', '我的翻译slug');

// 限定查询语言
$page = Page::whereTranslation('slug', '=', '我的翻译slug', ['en', 'de']);

// 排除默认语言
$page = Page::whereTranslation('slug', '=', '我的翻译slug', ['en', 'de'], false);

方法参数详解：