如何在Laravel多语言应用中实现用户输入与数据库内容的动态翻译

本教程将详细介绍如何在laravel多语言应用中处理用户输入和数据库内容的动态翻译。文章首先阐述laravel内置本地化机制对静态文本的适用性,接着引入google翻译小部件作为动态内容翻译的解决方案,并重点讲解如何利用translate和notranslatecss类实现选择性翻译,同时结合laravel的语言切换机制,实现无缝的用户体验。

Laravel内置本地化处理静态文本

Laravel框架提供了强大的本地化(Localization)功能,用于管理应用程序中的静态文本翻译。这通常通过语言文件来实现,这些文件存储在resources/lang目录下,根据不同的语言环境(如en、fr等)组织。

1. 定义语言文件

在resources/lang目录下,为每种支持的语言创建对应的文件夹和消息文件,例如messages.php:

/resources/lang/en/messages.php

 'Welcome Page',
    'welcome_message' => 'Hi, Welcome to this page',
    'author_information' => 'My name is Sanjay. This blog is mine and we created this post for you to learn.',
];

/resources/lang/fr/messages.php

 'Pagina de bienvenida',
    'welcome_message' => 'Hola bienvenido a esta pagina',
    'author_information' => 'Mi nombre es Sanjay. Este blog es mío y creamos esta publicación para que aprendas.',
];

2. 配置路由与控制器

为了实现语言切换功能,需要定义相应的路由和控制器:

routes/web.php

use App\Http\Controllers\LocalizationController;

Route::get('/', [LocalizationController::class, "index"]);
Route::get('change/lang', [LocalizationController::class, "lang_change"])->name('LangChange');

app/Http/Controllers/LocalizationController.php

lang);
        Session::put('locale', $request->lang); // 使用 Session Facade 存储语言
        return redirect()->back(); // 切换语言后重定向回上一页
    }
}

3. 视图中集成语言选择与显示

在视图文件中,可以通过下拉菜单让用户选择语言,并使用__辅助函数显示翻译后的文本:

resources/views/language.blade.php


 {{-- 设置HTML的lang属性为当前语言 --}}

    
    
    Multi-language Website
    
    


    
        
            

How to Create Multi Language Website in Laravel - Online Web Tutor Blog


Select Language:

{{ __('messages.page_title') }}

{{ __('messages.welcome_message') }}

{{ __('messages.author_information') }}

动态内容翻译的挑战与解决方案

Laravel的本地化机制主要用于翻译应用程序中预定义的静态文本。然而,对于用户通过表单输入并存储到数据库中的内容,或者从数据库动态读取的数据,Laravel的内置机制无法直接进行实时翻译。在这种情况下,我们需要一个能够处理动态内容的解决方案。

引入Google翻译小部件

Google翻译小部件(Google Translate Widget)是一个免费且易于集成的工具,可以帮助我们实现网页内容的实时翻译。它的优势在于能够翻译页面上的任何可见文本,包括由JavaScript动态生成或从数据库加载的内容。

1. 基本集成

首先,在你的HTML页面中(通常是resources/views/layouts/app.blade.php或其他主布局文件),添加Google翻译小部件的初始化代码。为了更好地控制翻译行为,通常会将其容器元素隐藏起来,并通过JavaScript来触发或管理其行为。


注意:pageLanguage应设置为你的网站默认内容语言,includedLanguages则列出所有你希望用户可以翻译到的语言。

2. 选择性翻译:translate与notranslate类

Google翻译小部件的一个强大功能是允许你通过CSS类来控制哪些元素应该被翻译,哪些应该被忽略。

  • notranslate类:带有此类的HTML元素及其子元素将不会被Google翻译。
  • translate类:如果父元素被标记为notranslate,但其内部的某个子元素需要被翻译,则可以给该子元素添加translate类。

应用策略: 为了确保只有动态内容被翻译,而静态的、已经通过Laravel本地化处理过的文本不被二次翻译,可以采用以下策略:

  • 将整个或主要内容区域标记为notranslate:这将阻止Google翻译处理大部分静态文本。
  • 给包含用户输入或数据库动态内容的元素添加translate类:这样,只有这些特定区域的内容会被Google翻译处理。

示例:

 {{-- 整个body标记为不翻译 --}}
    
        {{-- 静态文本,由Laravel本地化处理,不希望被Google翻译二次处理 --}}
        

{{ __('messages.page_title') }}

{{-- 假设这是从数据库中取出的用户评论或文章内容 --}}

This is a user comment: "I really enjoyed this article!"

Another dynamic piece of text: "The weather today is sunny and warm."

{{-- 另一个需要翻译的数据库内容 --}}

The product description from the database: "High-quality, durable, and stylish product."

{{-- 其他静态元素,保持不翻译 --}}

{{ __('messages.welcome_message') }}

通过这种方式,只有带有translate类的元素中的内容会被Google翻译小部件处理,从而避免了对已本地化的静态文本进行不必要的翻译,也避免了整个页面被意外翻译。

结合Laravel语言切换实现动态翻译

为了让Google翻译小部件的翻译目标语言与Laravel应用的当前语言保持一致,我们需要在Laravel切换语言时,同时更新Google翻译小部件的设置。这可以通过操作Google翻译设置的Cookie来实现。

当用户通过Laravel的语言选择器切换语言时,我们可以通过JavaScript设置googtrans Cookie,强制Google翻译小部件将页面内容翻译成新的目标语言。

更新的Google翻译初始化脚本:

将之前添加到页面中的Google翻译脚本更新为以下内容。这段代码会根据当前Laravel应用的语言(通过html标签的lang属性获取)来设置Google翻译的源语言和目标语言。


解释:

  1. setCookie函数用于设置或删除Cookie。
  2. googleTranslateElementInit函数首先获取HTML根元素上lang属性的值,这通常由Laravel的app()->getLocale()设置。
  3. 它根据当前应用语言决定Google翻译的targetTranslateLanguage。
  4. 通过设置googtrans Cookie,我们可以控制Google翻译小部件将页面从defaultPageLanguage翻译到targetTranslateLanguage。如果targetTranslateLanguage与defaultPageLanguage相同,或者为空,则删除Cookie以确保页面不被翻译。
  5. 这样,当用户在Laravel中切换语言时,Google翻译也会相应地调整其翻译行为,实现动态内容的同步翻译。

注意事项与总结

  • 翻译准确性:Google翻译是机器翻译,可能存在不准确或不自然的翻译。对于关键业务内容,仍推荐人工翻译或专业的翻译服务。
  • SEO影响:Google翻译小部件是客户端JavaScript,它在用户浏览器中动态修改内容。搜索引擎通常无法索引这些动态翻译后的内容,因此对SEO没有直接帮助。如果SEO是主要考虑因素,应考虑服务器端的多语言方案。
  • 性能开销:加载Google翻译小部件会增加页面加载时间。
  • 用户体验:虽然方便,但客户端翻译有时会导致页面元素跳动或加载延迟,影响用户体验。
  • 混合策略:最佳实践是结合使用Laravel的本地化功能处理静态、预定义文本,并利用Google翻译小部件(或其他API服务)处理用户生成或数据库中的动态内容。这种混合策略能够在开发效率和翻译效果之间取得平衡。

通过上述方法,你可以在Laravel多语言应用中有效地管理静态文本和动态内容的翻译,为用户提供更全面的多语言体验。