Laravel怎么处理多语言_Laravel本地化i18n教程【国际】

laravel多语言路由需用route::prefix(‘{locale}’)->middleware(‘setlocale’)并验证白名单，语言文件须放resources/lang/{locale}/{file}.php，__()/@lang需配合占位符参数，切换语言须通过session或cookie持久化并按优先级链推导locale。

怎么在 laravel 路由里正确加载多语言前缀

路由必须显式支持语言参数，否则 app()->setLocale() 早于请求解析，本地化字符串不会按访问语言生效。

• 在 routes/web.php 顶部加 Route::prefix('{locale}')->middleware('setlocale')，别直接写死 /en 或 /zh
• setlocale 中间件要手动创建，里面调用 app()->setLocale($request->locale)，并验证 $request->locale 是否在 config('app.locales') 白名单里
• 别漏掉 fallback_locale 配置 —— 当 {locale} 不匹配任何支持语言时，Laravel 默认用 config('app.fallback_locale')，不是 config('app.locale')
• 生成 URL 时用 route('home', ['locale' => 'ja'])，别拼字符串；否则带 locale 的命名路由会 404

Laravel 的 __() 函数为什么总返回英文

常见原因是语言文件没放对位置，或 key 写法和文件结构不匹配，__() 找不到对应翻译就回退到原始字符串（看起来像“没生效”）。

• 语言文件路径必须是 resources/lang/{locale}/{file}.php，比如日语的用户提示要放在 resources/lang/ja/validation.php，不是 resources/lang/ja/messages.php
• 如果用 __('auth.failed')，就得确保 resources/lang/en/auth.php 里有 'failed' => 'These credentials do not match our records.'
• 执行 php artisan lang:publish 并不能自动补全自定义语言包，它只复制框架内置的 en 文件；新增语言得手动建目录、复制+改内容
• 缓存开启时（APP_DEBUG=false），修改语言文件必须运行 php artisan view:clear && php artisan config:clear，否则旧翻译仍被读取

如何让 Blade 模板里的 @lang 支持变量插值

@lang 本身不解析占位符，它只是原样输出语言数组里的字符串；变量替换得靠 :Attribute 这类命名占位符 + trans() 或 __() 的第二个参数。

• 语言文件中写 'custom_message' => 'The :attribute must be at least :min characters.'
• 模板里用 {{ __('custom_message', ['attribute' => 'password', 'min' => 8]) }}，不是 @lang('custom_message', [...])（后者语法错误）
• 验证规则中的 :attribute 是 Laravel 自动注入的，但自定义提示必须显式传参，__('validation.custom.password.min', [...]) 也一样
• 别在语言文件里写 PHP 代码（如 = $var ?>），Laravel 不执行，只会当纯文本输出

切换语言时 session 或 cookie 怎么持久化

单纯改 app()->setLocale() 只影响当前请求；下次刷新又回到 config('app.locale')，必须把选择存下来并主动读取。

• 推荐用 session：用户点击语言切换链接时，发 POST 到 /locale/set，控制器里写 session(['locale' => $request->locale])
• 然后在中间件里优先读 session('locale')，再 fallback 到 URL 参数、浏览器 Accept-Language、最后才是配置默认值
• Cookie 方案更轻量，但注意 setcookie() 在响应头发送，中间件里要用 response()->withCookie(cookie('locale', $locale, 365 * 24))
• 别在 AppServiceProvider::boot() 里硬编码 app()->setLocale('fr') —— 这会让所有请求强制法语，覆盖用户选择

语言切换不是设个变量就完事，关键在「请求进来时，怎么从多个来源（URL / session / cookie / header）可靠地推导出本次该用哪个 locale」。这个决策链一旦写错，后面所有 __() 都白搭。