
本教程将详细介绍如何在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. 基本集成
动态WEB网站中的PHP和MySQL详细反映实际程序的需求,仔细地探讨外部数据的验证(例如信用卡卡号的格式)、用户登录以及如何使用模板建立网页的标准外观。动态WEB网站中的PHP和MySQL的内容不仅仅是这些。书中还提到如何串联JavaScript与PHP让用户操作时更快、更方便。还有正确处理用户输入错误的方法,让网站看起来更专业。另外还引入大量来自PEAR外挂函数库的强大功能,对常用的、强大的包
首先,在你的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翻译的源语言和目标语言。
解释:
- setCookie函数用于设置或删除Cookie。
- googleTranslateElementInit函数首先获取HTML根元素上lang属性的值,这通常由Laravel的app()->getLocale()设置。
- 它根据当前应用语言决定Google翻译的targetTranslateLanguage。
- 通过设置googtrans Cookie,我们可以控制Google翻译小部件将页面从defaultPageLanguage翻译到targetTranslateLanguage。如果targetTranslateLanguage与defaultPageLanguage相同,或者为空,则删除Cookie以确保页面不被翻译。
- 这样,当用户在Laravel中切换语言时,Google翻译也会相应地调整其翻译行为,实现动态内容的同步翻译。
注意事项与总结
- 翻译准确性:Google翻译是机器翻译,可能存在不准确或不自然的翻译。对于关键业务内容,仍推荐人工翻译或专业的翻译服务。
- SEO影响:Google翻译小部件是客户端JavaScript,它在用户浏览器中动态修改内容。搜索引擎通常无法索引这些动态翻译后的内容,因此对SEO没有直接帮助。如果SEO是主要考虑因素,应考虑服务器端的多语言方案。
- 性能开销:加载Google翻译小部件会增加页面加载时间。
- 用户体验:虽然方便,但客户端翻译有时会导致页面元素跳动或加载延迟,影响用户体验。
- 混合策略:最佳实践是结合使用Laravel的本地化功能处理静态、预定义文本,并利用Google翻译小部件(或其他API服务)处理用户生成或数据库中的动态内容。这种混合策略能够在开发效率和翻译效果之间取得平衡。
通过上述方法,你可以在Laravel多语言应用中有效地管理静态文本和动态内容的翻译,为用户提供更全面的多语言体验。









