当前位置：首页 > news >正文

aspire-contextualsentence-singlem-biomed vs Specter：生物医学文档相似性模型终极对比指南

news 2026/8/8 18:09:57

Laravel Localization终极指南：10分钟快速搭建多语言应用

【免费下载链接】laravel-localizationEasy localization for Laravel项目地址: https://gitcode.com/gh_mirrors/la/laravel-localization

想要为你的Laravel应用添加多语言支持吗？Laravel Localization是Laravel生态系统中最受欢迎的国际化（i18n）包之一，它可以让你轻松实现多语言网站和应用。这个强大的工具不仅能自动检测用户浏览器语言，还能提供智能重定向、翻译路由等高级功能，让你的应用轻松支持全球用户访问。🚀

📦 快速安装与配置

开始使用Laravel Localization非常简单，只需几个步骤即可完成安装和基础配置：

一键安装步骤

首先通过Composer安装包：

composer require mcamara/laravel-localization

发布配置文件

安装完成后，发布配置文件到你的项目：

php artisan vendor:publish --provider="Mcamara\LaravelLocalization\LaravelLocalizationServiceProvider"

配置支持的语言

在生成的config/laravellocalization.php文件中，你可以配置支持的语言。默认支持英语和西班牙语：

'supportedLocales' => [ 'en' => ['name' => 'English', 'script' => 'Latn', 'native' => 'English', 'regional' => 'en_GB'], 'es' => ['name' => 'Spanish', 'script' => 'Latn', 'native' => 'español', 'regional' => 'es_ES'], // 添加更多语言... ],

注册中间件

在Laravel 11及更高版本中，在bootstrap/app.php文件中注册中间件：

return Application::configure(basePath: dirname(__DIR__)) ->withMiddleware(function (Middleware $middleware) { $middleware->alias([ 'localize' => \Mcamara\LaravelLocalization\Middleware\LaravelLocalizationRoutes::class, 'localizationRedirect' => \Mcamara\LaravelLocalization\Middleware\LaravelLocalizationRedirectFilter::class, 'localeSessionRedirect' => \Mcamara\LaravelLocalization\Middleware\LocaleSessionRedirect::class, 'localeCookieRedirect' => \Mcamara\LaravelLocalization\Middleware\LocaleCookieRedirect::class, 'localeViewPath' => \Mcamara\LaravelLocalization\Middleware\LaravelLocalizationViewPath::class, ]); });

🌐 基础使用教程

最简单的路由配置

在你的routes/web.php文件中添加本地化路由组：

Route::group(['prefix' => LaravelLocalization::setLocale()], function() { /** 所有本地化路由都放在这个组内 **/ Route::get('/', function() { return view('welcome'); }); Route::get('about', function() { return view('about'); }); });

这样配置后，你的应用将自动支持以下URL：

http://your-domain.com/en(英语)
http://your-domain.com/es(西班牙语)
http://your-domain.com/en/about
http://your-domain.com/es/about

智能重定向中间件

为了更好的用户体验，建议添加重定向中间件：

Route::group([ 'prefix' => LaravelLocalization::setLocale(), 'middleware' => ['localeSessionRedirect', 'localizationRedirect', 'localeViewPath'] ], function() { // 你的路由... });

🔧 高级功能详解

翻译路由功能

Laravel Localization最强大的功能之一是翻译路由。这意味着你可以为不同语言定义不同的URL路径：

在resources/lang/en/routes.php中：

return [ "about" => "about", "article" => "article/{article}", ];

在resources/lang/es/routes.php中：

return [ "about" => "acerca", "article" => "articulo/{article}", ];

在路由文件中使用：

Route::group(['prefix' => LaravelLocalization::setLocale(), 'middleware' => ['localize']], function () { Route::get(LaravelLocalization::transRoute('routes.about'), function () { return view('about'); }); });

现在/en/about和/es/acerca都会指向同一个控制器/视图！

语言选择器实现

创建一个用户友好的语言选择器非常简单：

<ul> @foreach(LaravelLocalization::getSupportedLocales() as $localeCode => $properties) <li> <a rel="alternate" hreflang="{{ $localeCode }}" href="{{ LaravelLocalization::getLocalizedURL($localeCode, null, [], true) }}"> {{ $properties['native'] }} </a> </li> @endforeach </ul>

🚀 实用工具函数

Laravel Localization提供了许多有用的辅助函数：

获取本地化URL

// 获取当前URL的英语版本 {{ LaravelLocalization::getLocalizedURL('en') }} // 获取指定路由的本地化URL {{ LaravelLocalization::getURLFromRouteNameTranslated('es', 'routes.about') }}

语言信息获取

// 获取所有支持的语言 {{ LaravelLocalization::getSupportedLocales() }} // 获取当前语言代码 {{ LaravelLocalization::getCurrentLocale() }} // 获取当前语言名称 {{ LaravelLocalization::getCurrentLocaleName() }} // 获取当前语言方向（ltr/rtl） {{ LaravelLocalization::getCurrentLocaleDirection() }}

⚡ 性能优化技巧

路由缓存支持

默认情况下，Laravel的路由缓存不兼容本地化路由。但Laravel Localization提供了解决方案：

在AppServiceProvider中添加trait：

use Mcamara\LaravelLocalization\Traits\LoadsTranslatedCachedRoutes; class AppServiceProvider extends ServiceProvider { use LoadsTranslatedCachedRoutes; public function boot(): void { RouteServiceProvider::loadCachedRoutesUsing(fn () => $this->loadCachedRoutes()); } }

使用专用命令缓存路由：

php artisan route:trans:cache

清除缓存：

php artisan route:trans:clear

视图组织优化

通过localeViewPath中间件，你可以按语言组织视图文件：

resources/views/en/
resources/views/es/
resources/views/fr/

这样可以让代码结构更清晰，便于维护。

🐛 常见问题解决

POST请求不工作

如果POST请求被重定向为GET请求，可能是因为你没有本地化表单的action URL：

❌错误做法：

<form action="/logout" method="POST">

✅正确做法：

<form action="{{ \LaravelLocalization::localizeURL('/logout') }}" method="POST">

验证消息只显示默认语言

这个问题通常也是由于未本地化POST URL导致的。确保所有表单的action都使用本地化URL。

测试中的404错误

在测试环境中，你需要手动设置语言环境：

use Mcamara\LaravelLocalization\LaravelLocalization; protected function refreshApplicationWithLocale(string $locale): void { self::tearDown(); putenv(LaravelLocalization::ENV_ROUTE_KEY . '=' . $locale); self::setUp(); }

📁 项目结构概览

了解Laravel Localization的源码结构有助于更好地使用它：

src/Mcamara/LaravelLocalization/ ├── Commands/ # 命令行工具 │ ├── RouteTranslationsCacheCommand.php │ ├── RouteTranslationsClearCommand.php │ └── RouteTranslationsListCommand.php ├── Exceptions/ # 异常处理 ├── Facades/ # 门面类 ├── Interfaces/ # 接口定义 ├── Middleware/ # 中间件 │ ├── LaravelLocalizationMiddlewareBase.php │ ├── LaravelLocalizationRedirectFilter.php │ ├── LaravelLocalizationRoutes.php │ ├── LaravelLocalizationViewPath.php │ ├── LocaleCookieRedirect.php │ └── LocaleSessionRedirect.php ├── Traits/ # 特性类 ├── LanguageNegotiator.php # 语言协商器 ├── LaravelLocalization.php # 主类 └── LaravelLocalizationServiceProvider.php # 服务提供者