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

碧海醫心
发布: 2025-11-04 11:55:28
原创
630人浏览过

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

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

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

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

1. 定义语言文件

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

/resources/lang/en/messages.php

<?php

return [
    'page_title' => '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

<?php

return [
    'page_title' => '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

<?php

namespace App\Http\Controllers;
use Illuminate\Http\Request;
use Illuminate\Support\Facades\App;
use Illuminate\Support\Facades\Session; // 确保引入 Session Facade

class LocalizationController extends Controller
{
    public function index()
    {
        return view('language');
    }

    public function lang_change(Request $request)
    {
        App::setLocale($request->lang);
        Session::put('locale', $request->lang); // 使用 Session Facade 存储语言
        return redirect()->back(); // 切换语言后重定向回上一页
    }
}
登录后复制

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

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

resources/views/language.blade.php

<!DOCTYPE html>
<html lang="{{ app()->getLocale() }}"> {{-- 设置HTML的lang属性为当前语言 --}}
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>Multi-language Website</title>
    <link rel="stylesheet" href="https://stackpath.bootstrapcdn.com/bootstrap/4.5.2/css/bootstrap.min.css">
    <script src="https://ajax.googleapis.com/ajax/libs/jquery/3.5.1/jquery.min.js"></script>
</head>
<body>
    <div class="container">
        <div class="row" style="text-align: center;margin-top: 40px;">
            <h2>How to Create Multi Language Website in Laravel - Online Web Tutor Blog</h2><br>
            <div class="col-md-2 col-md-offset-3 text-right">
                <strong>Select Language: </strong>
            </div>
            <div class="col-md-4">
                <select class="form-control Langchange">
                    <option value="en" {{ session()->get('locale') == 'en' ? 'selected' : '' }}>English</option>
                    <option value="fr" {{ session()->get('locale') == 'fr' ? 'selected' : '' }}>French</option>
                    {{-- 注意:示例中原始代码使用了es,这里根据fr文件调整 --}}
                </select>
            </div>
            <h1 style="margin-top: 80px;">{{ __('messages.page_title') }}</h1>
            <h2 style="margin-top: 80px;">{{ __('messages.welcome_message') }}</h2>
            <h3 style="margin-top: 80px;">{{ __('messages.author_information') }}</h3>
        </div>
    </div>

    <script type="text/javascript">
        var url = "{{ route('LangChange') }}";
        $(".Langchange").change(function(){
            window.location.href = url + "?lang="+ $(this).val();
        });
    </script>
</body>
</html>
登录后复制

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

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

引入Google翻译小部件

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

ViiTor实时翻译
ViiTor实时翻译

AI实时多语言翻译专家!强大的语音识别、AR翻译功能。

ViiTor实时翻译 116
查看详情 ViiTor实时翻译

1. 基本集成

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

<div id="google_translate_element" style="display:none;"></div>
<script type="text/javascript">
    function googleTranslateElementInit() {
        // 初始化Google翻译,指定页面语言和可翻译的语言
        new google.translate.TranslateElement({
            pageLanguage: 'en', // 默认页面语言,可以根据Laravel的当前语言动态设置
            includedLanguages: 'en,fr,es,ar', // 包含所有你希望支持的翻译目标语言
            autoDisplay: false // 不自动显示翻译选择器
        }, 'google_translate_element');
    }
</script>
<script type="text/javascript" src="//translate.google.com/translate_a/element.js?cb=googleTranslateElementInit"></script>
登录后复制

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

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

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

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

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

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

示例:

<body class="notranslate"> {{-- 整个body标记为不翻译 --}}
    <div class="container">
        {{-- 静态文本,由Laravel本地化处理,不希望被Google翻译二次处理 --}}
        <h1 style="margin-top: 80px;">{{ __('messages.page_title') }}</h1>

        {{-- 假设这是从数据库中取出的用户评论或文章内容 --}}
        <div class="user-generated-content translate">
            <p>This is a user comment: "I really enjoyed this article!"</p>
            <p>Another dynamic piece of text: "The weather today is sunny and warm."</p>
        </div>

        {{-- 另一个需要翻译的数据库内容 --}}
        <p class="translate">The product description from the database: "High-quality, durable, and stylish product."</p>

        {{-- 其他静态元素,保持不翻译 --}}
        <h2 style="margin-top: 80px;">{{ __('messages.welcome_message') }}</h2>
    </div>
</body>
登录后复制

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

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

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

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

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

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

<div id="google_translate_element" style="display:none;"></div>
<script type="text/javascript">
    // 辅助函数:设置Cookie
    function setCookie(name, value, days) {
        var expires = "";
        if (days) {
            var date = new Date();
            date.setTime(date.getTime() + (days * 24 * 60 * 60 * 1000));
            expires = "; expires=" + date.toUTCString();
        }
        document.cookie = name + "=" + (value || "")  + expires + "; path=/";
    }

    function googleTranslateElementInit() {
        var currentAppLocale = document.documentElement.lang; // 获取Laravel设置的当前语言,例如 'en', 'fr'
        var defaultPageLanguage = 'en'; // 你的网站内容默认语言,如果Laravel当前语言是默认语言,则不进行翻译
        var targetTranslateLanguage = '';

        if (currentAppLocale && currentAppLocale !== defaultPageLanguage) {
            // 如果Laravel的当前语言不是默认语言,则将Google翻译的目标语言设置为当前应用语言
            targetTranslateLanguage = currentAppLocale;
        } else {
            // 如果Laravel的当前语言是默认语言,或者没有设置,则不进行翻译(或翻译回默认语言)
            targetTranslateLanguage = defaultPageLanguage; // 或者设置为空字符串,表示不进行翻译
        }

        // 设置googtrans cookie来控制Google翻译的行为
        // 格式为 /源语言/目标语言
        // 如果 targetTranslateLanguage 为空,则表示不翻译
        if (targetTranslateLanguage && targetTranslateLanguage !== defaultPageLanguage) {
            setCookie('googtrans', '/' + defaultPageLanguage + '/' + targetTranslateLanguage, 1);
        } else {
            // 如果目标语言是默认语言或为空,则删除googtrans cookie以禁用翻译
            setCookie('googtrans', '', -1); // 设置过期时间为过去,删除cookie
        }


        new google.translate.TranslateElement({
            pageLanguage: defaultPageLanguage, // 页面原始语言
            includedLanguages: 'en,fr,es,ar', // 包含所有支持的翻译目标语言
            autoDisplay: false // 不自动显示翻译选择器
        }, 'google_translate_element');
    }
</script>
<script type="text/javascript" src="//translate.google.com/translate_a/element.js?cb=googleTranslateElementInit"></script>
登录后复制

解释:

  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多语言应用中有效地管理静态文本和动态内容的翻译,为用户提供更全面的多语言体验。

以上就是如何在Laravel多语言应用中实现用户输入与数据库内容的动态翻译的详细内容,更多请关注php中文网其它相关文章!

最佳 Windows 性能的顶级免费优化软件
最佳 Windows 性能的顶级免费优化软件

每个人都需要一台速度更快、更稳定的 PC。随着时间的推移,垃圾文件、旧注册表数据和不必要的后台进程会占用资源并降低性能。幸运的是,许多工具可以让 Windows 保持平稳运行。

下载
来源:php中文网
本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn
最新问题
开源免费商场系统广告
热门教程
更多>
最新下载
更多>
网站特效
网站源码
网站素材
前端模板
关于我们 免责申明 意见反馈 讲师合作 广告合作 最新更新 English
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送
PHP中文网APP
随时随地碎片化学习

Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号