本教程将详细介绍如何在laravel多语言应用中处理用户输入和数据库内容的动态翻译。文章首先阐述laravel内置本地化机制对静态文本的适用性,接着引入google翻译小部件作为动态内容翻译的解决方案,并重点讲解如何利用translate和notranslatecss类实现选择性翻译,同时结合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的本地化机制主要用于翻译应用程序中预定义的静态文本。然而,对于用户通过表单输入并存储到数据库中的内容,或者从数据库动态读取的数据,Lar
avel的内置机制无法直接进行实时翻译。在这种情况下,我们需要一个能够处理动态内容的解决方案。
引入Google翻译小部件
Google翻译小部件(Google Translate Widget)是一个免费且易于集成的工具,可以帮助我们实现网页内容的实时翻译。它的优势在于能够翻译页面上的任何可见文本,包括由JavaScript动态生成或从数据库加载的内容。
1. 基本集成
首先,在你的HTML页面中(通常是resources/views/layouts/app.blade.php或其他主布局文件),添加Google翻译小部件的初始化代码。为了更好地控制翻译行为,通常会将其容器元素隐藏起来,并通过JavaScript来触发或管理其行为。
注意:pageLanguage应设置为你的网站默认内容语言,includedLanguages则列出所有你希望用户可以翻译到的语言。
2. 选择性翻译:translate与notranslate类
Google翻译小部件的一个强大功能是允许你通过CSS类来控制哪些元素应该被翻译,哪些应该被忽略。
应用策略: 为了确保只有动态内容被翻译,而静态的、已经通过Laravel本地化处理过的文本不被二次翻译,可以采用以下策略:
示例:
{{-- 整个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翻译小部件处理,从而避免了对已本地化的静态文本进行不必要的翻译,也避免了整个页面被意外翻译。
为了让Google翻译小部件的翻译目标语言与Laravel应用的当前语言保持一致,我们需要在Laravel切换语言时,同时更新Google翻译小部件的设置。这可以通过操作Google翻译设置的Cookie来实现。
当用户通过Laravel的语言选择器切换语言时,我们可以通过JavaScript设置googtrans Cookie,强制Google翻译小部件将页面内容翻译成新的目标语言。
更新的Google翻译初始化脚本:
将之前添加到页面中的Google翻译脚本更新为以下内容。这段代码会根据当前Laravel应用的语言(通过html标签的lang属性获取)来设置Google翻译的源语言和目标语言。
解释:
通过上述方法,你可以在Laravel多语言应用中有效地管理静态文本和动态内容的翻译,为用户提供更全面的多语言体验。