Laravel中间件设置语言方法详解

本文深入讲解了在 Laravel 应用中通过中间件实现请求级自动语言切换的五种实用策略——从基于浏览器 Accept-Language 头的无状态识别，到 URL 路径前缀、用户会话、Cookie 偏好，再到多源协商的智能优先级融合方案，每种方法均附带可直接落地的代码实现与精准注册位置说明，帮助开发者彻底解决本地化配置延迟导致翻译不生效的痛点，让多语言支持既灵活可靠又开箱即用。

如果您在 Laravel 应用中需要根据请求自动切换语言环境，但当前页面未按预期显示对应语言的翻译，则可能是由于本地化配置未在请求生命周期早期生效。以下是实现请求级自动语言设置的多种中间件方法：

一、基于 HTTP 头 Accept-Language 的中间件

该方法通过解析客户端请求头中的 Accept-Language 字段，提取优先级最高的支持语言，并将其设为当前请求的本地化语言。它不依赖会话或 Cookie，适用于无状态 API 或首次访问场景。

1、在 app/Http/Middleware 目录下创建 LocalizeByAcceptLanguage.php 文件，内容如下：

2、在 handle 方法中使用 $request->getPreferredLanguage(['zh', 'en', 'ja']) 获取匹配的支持语言列表。

3、调用 app()->setLocale($locale) 设置当前应用的本地化语言。

4、将该中间件注册到 app/Http/Kernel.php 的 $middlewareGroups['web'] 中，确保其位于 \App\Http\Middleware\EncryptCookies::class 之后、\Illuminate\Cookie\Middleware\AddQueuedCookiesToResponse::class 之前。

二、基于 URL 路径前缀的中间件

该方法从请求路径中提取语言代码（如 /zh/login 或 /en/register），并据此设置本地化语言。它显式、可预测，且对 SEO 友好，适用于多语言网站的常规路由结构。

1、定义支持的语言数组：$supportedLocales = ['zh', 'en', 'ja', 'ko']。

2、使用 $request->segment(1) 获取 URL 第一段路径片段。

3、判断该片段是否存在于 $supportedLocales 中；若存在，则调用 app()->setLocale($locale) 并使用 $request->route()->setParameter('locale', $locale) 保留语言参数供后续路由使用。

4、调用 $next($request) 继续请求流程。

三、基于用户认证后会话存储的中间件

该方法在用户已登录的前提下，读取其 profile 表中预设的 language 字段值，并覆盖当前请求的语言设置。它优先级高于 Accept-Language，适用于用户个性化偏好持久化场景。

1、检查 $request->user() 是否存在且为已认证实例。

2、调用 $request->user()->language 获取数据库中保存的语言代码。

3、验证该语言代码是否属于 config('app.supported_locales') 配置项中的合法值。

4、确认有效后执行 app()->setLocale($locale)，并可选地调用 session(['locale' => $locale]) 同步会话状态。

四、基于 Cookie 值的中间件

该方法从请求 Cookie 中读取名为 locale 的键值，用于恢复用户上次选择的语言偏好。它独立于认证状态，适合访客级语言记忆功能。

1、使用 $request->cookie('locale') 获取 Cookie 值。

2、校验该值是否非空且在应用支持的语言列表内。

3、若校验通过，执行 app()->setLocale($locale) 并调用 $request->session()->put('locale', $locale) 确保会话同步。

4、若 Cookie 无效，不作任何设置，允许后续中间件（如 Accept-Language）接管。

五、多源语言协商的组合中间件

该方法按明确优先级顺序依次尝试多种语言来源：用户会话 > Cookie > URL 路径 > 请求头 > 默认语言。它避免单一策略失效导致本地化中断，提升鲁棒性。

1、按顺序检查 $request->session()->get('locale') 是否存在且合法。

2、若否，检查 $request->cookie('locale')。

3、若否，检查 $request->segment(1) 是否为支持语言。

4、若否，调用 $request->getPreferredLanguage(config('app.supported_locales'))。

5、最终选定语言后，统一执行 app()->setLocale($locale) 并调用 Lang::setLocale($locale) 确保翻译服务同步更新。

本篇关于《Laravel中间件设置语言方法详解》的介绍就到此结束啦，但是学无止境，想要了解学习更多关于文章的相关知识，请关注golang学习网公众号！