本文将深入探讨在 Laravel 多语言应用中，如何有效处理用户输入数据的翻译问题。虽然 Laravel 提供了强大的本地化机制来翻译静态文本，但对于存储在数据库中的用户动态内容，需要借助 Google 翻译工具的客户端能力，通过巧妙结合 `translate` 和 `notranslate` CSS 类，实现按需翻译，并可与 Laravel 的语言切换机制协同工作。
引言：Laravel 本地化与动态内容翻译的挑战
Laravel 框架通过其内置的本地化功能，为构建多语言网站提供了便捷的解决方案。开发者可以通过在 resources/lang 目录下创建不同语言的翻译文件，并使用 __('key') 助手函数轻松地在视图中渲染多语言的静态文本。然而，这种机制主要针对预定义的、静态的文本内容。
当涉及到用户通过表单提交并存储到数据库中的动态数据时，Laravel 的本地化机制就无法直接应用了。例如，用户以英文提交了一篇文章标题和内容，如果网站当前语言环境切换到法语，这些动态内容并不会自动翻译。这就对多语言应用提出了新的挑战：如何在不修改数据库结构（例如为每个字段存储多个语言版本）的前提下，实现用户输入内容的实时翻译？
本文将介绍一种利用客户端 Google 翻译工具解决这一问题的策略，实现对特定动态内容的按需翻译。
集成 Google 翻译工具实现页面内容翻译
要实现用户输入数据的动态翻译，我们可以借助 Google 翻译提供的客户端小部件。
1. 基本集成
首先，在您的 Laravel 视图文件中（例如 resources/views/layouts/app.blade.php 或包含动态内容的特定视图），添加以下 HTML 元素和 JavaScript 代码来初始化 Google 翻译小部件：
<div id="google_translate_element" style="display:none;"></div>
<script type="text/javascript">
function googleTranslateElementInit() {
new google.translate.TranslateElement({
pageLanguage: 'en', // 页面内容的原始语言，假设用户输入数据默认是英文
includedLanguages: 'en,fr,es,ar', // 可翻译的目标语言列表
layout: google.translate.TranslateElement.InlineLayout.SIMPLE, // 翻译界面的布局
autoDisplay: false // 不自动显示Google翻译的下拉菜单，我们将通过JS控制
}, 'google_translate_element');
}
</script>
<script type="text/javascript" src="//translate.google.com/translate_a/element.js?cb=googleTranslateElementInit"></script>代码说明：
- #google_translate_element：这是一个占位符 div，Google 翻译小部件会在此处渲染。我们将其设置为 display:none; 以隐藏默认的下拉菜单，因为我们将通过 JavaScript 进行控制。
- pageLanguage: 'en'：这告诉 Google 翻译，页面上大部分内容的原始语言是英文。如果您的用户输入数据主要以其他语言存储，请相应调整。
- includedLanguages: 'en,fr,es,ar'：定义了用户可以选择翻译到的目标语言。
- autoDisplay: false：禁用 Google 翻译默认的浮动下拉菜单。
2. 初步问题：全页面翻译
默认情况下，当 Google 翻译小部件被激活时，它会尝试翻译整个页面的所有可见文本内容。这通常不是我们期望的行为，因为我们希望 Laravel 的本地化机制处理静态文本，而 Google 翻译只处理动态的用户输入数据。为了解决这个问题，我们需要更精细地控制翻译范围。
精细控制翻译范围：translate 和 notranslate 类
Google 翻译小部件提供了一对非常有用的 CSS 类，允许开发者精确控制哪些内容需要翻译，哪些内容应保持不变。
1. 核心机制
- notranslate 类： 任何带有 notranslate 类的 HTML 元素及其所有子元素都将被 Google 翻译工具忽略，不会被翻译。
- translate 类： 当一个元素的父级或整个页面被标记为 notranslate 时，如果某个子元素带有 translate 类，那么该子元素将会被翻译。
2. 应用策略
为了实现对用户输入数据的选择性翻译，推荐以下策略：
-
将大部分页面内容标记为 notranslate： 通常，您可以将 <body> 标签或包含大部分静态内容的顶级 div 元素添加 notranslate 类。这样可以确保由 Laravel 本地化处理的静态文本不会被 Google 翻译干扰。
<body class="notranslate"> <!-- Laravel 静态文本，不会被Google翻译 --> <h1>{{ __('message.page_title') }}</h1> <p>{{ __('message.welcome_message') }}</p> <!-- 其他页面内容... --> </body> -
仅对包含动态用户数据的元素添加 translate 类： 对于那些从数据库中获取并展示的用户输入数据（例如文章标题、评论内容、产品描述等），将其所在的 HTML 元素（如 <div>, <p>, <span> 等）添加 translate 类。
<body class="notranslate"> <!-- ... 静态内容 ... --> <div class="container"> <h3>用户文章标题: <span class="translate">{{ $article->title }}</span></h3> <p class="translate">{{ $article->content }}</p> <h4>用户评论:</h4> @foreach($comments as $comment) <p><span class="translate">{{ $comment->text }}</span> - {{ $comment->author }}</p> @endforeach </div> <!-- ... 其他内容 ... --> </body>
通过这种方式，Google 翻译只会处理带有 translate 类的动态内容，而不会触及其他静态或不需要翻译的部分，从而实现精确控制。
与 Laravel 语言切换机制协同
为了让 Google 翻译工具与 Laravel 应用的语言切换机制无缝协作，我们需要在用户切换语言时，动态地通知 Google 翻译目标语言。这可以通过设置 googtrans cookie 来实现。
1. googtrans Cookie 原理
Google 翻译小部件会读取一个名为 googtrans 的 cookie 来决定翻译的源语言和目标语言。该 cookie 的格式为 /源语言代码/目标语言代码。例如，/en/fr 表示将内容从英文翻译成法文。
2. 实现步骤
假设您的用户输入数据始终以一种原始语言（例如英文 en）存储。当用户在 Laravel 应用中通过下拉菜单选择不同的语言时，您需要：
- 获取当前 Laravel 应用的语言环境（即用户希望看到的语言）。
- 设置 googtrans cookie，指示 Google 翻译将内容从原始语言翻译到当前应用语言。
- 如果当前应用语言与原始语言相同，可以清除翻译 cookie 或设置为 /en/en，以避免不必要的翻译。
以下是一个修改后的 JavaScript 示例，用于在 Laravel 语言切换时更新 Google 翻译：
<!-- 您的语言切换下拉菜单 (示例) -->
<select class="form-control Langchange">
<option value="en" {{ session()->get('locale') == 'en' ? 'selected' : '' }}>English</option>
<option value="fr" {{ session()->get('locale') == 'fr' ? 'selected' : '' }}>Français</option>
<option value="es" {{ session()->get('locale') == 'es' ? 'selected' : '' }}>Español</option>
<!-- 更多语言选项 -->
</select>
<!-- Google 翻译小部件的占位符 -->
<div id="google_translate_element" style="display:none;"></div>
<script type="text/javascript">
// 假设用户输入数据的原始存储语言是英文
const originalDataLang = 'en';
// 辅助函数：设置Cookie
function setCookie(key, value, expiry) {
var expires = new Date();
expires.setTime(expires.getTime() + (expiry * 24 * 60 * 60 * 1000));
document.cookie = key + '=' + value + ';expires=' + expires.toUTCString() + ';path=/';
}
// Google 翻译初始化函数
function googleTranslateElementInit() {
new google.translate.TranslateElement({
pageLanguage: originalDataLang, // 告诉Google翻译页面内容的原始语言
includedLanguages: 'en,fr,es,ar', // 包含所有支持的语言
layout: google.translate.TranslateElement.InlineLayout.SIMPLE,
autoDisplay: false
}, 'google_translate_element');
// 初始化时根据当前语言设置翻译
updateGoogleTranslateCookie();
}
// 监听语言切换下拉菜单的变化
$(".Langchange").change(function(){
var selectedLang = $(this).val();
// 更新 Laravel 的语言环境 (通过路由或Ajax)
window.location.href = "{{ route('LangChange') }}" + "?lang=" + selectedLang;
// 在页面刷新后，googleTranslateElementInit 会再次调用，并设置正确的cookie
});
// 在页面加载或语言切换后调用，以设置Google翻译cookie
function updateGoogleTranslateCookie() {
// 获取当前 Laravel 应用的语言环境 (从session或HTML lang属性)
// 假设当前页面的HTML lang属性已经由Laravel根据session设置 
