Laravel 8 多语言切换：正确使用 JSON 语言文件与会话持久化

在 laravel 8 中启用基于 `resources/lang/*.json` 的多语言支持时，仅调用 `app::setlocale()` 不足以实现页面级语言切换——必须将用户选择的语言持久化至 session（或数据库），并避免在请求中执行 artisan 命令。

Laravel 自带的本地化系统原生支持 JSON 语言文件（如 resources/lang/en.json、resources/lang/ar.json），无需额外配置即可直接使用 __() 或 @lang 辅助函数。但关键在于：语言切换必须是请求上下文感知且可持久化的。你当前代码中在 switchLang 方法和中间件里反复调用 config:clear、config:cache 和 cache:clear 是严重错误——这些 Artisan 命令会清空全站缓存、重写配置，不仅性能极差，更会导致并发请求异常、会话丢失，且对单次请求的语言切换毫无帮助（配置缓存影响的是框架启动时的配置加载，而非运行时的 locale）。

✅ 正确做法是：

1. 将用户选择的语言存入 Session（推荐轻量方案）：
   在控制器中设置 locale 并保存到 session：

   // app/Http/Controllers/HomeController.php
   public function switchLang($lang)
   {
       // 验证语言代码合法性（可选但强烈建议）
       $supportedLocales = ['en', 'ar'];
       if (!in_array($lang, $supportedLocales)) {
           abort(400, 'Unsupported language');
       }
   
       // 设置当前请求 locale 并持久化至 session
       App::setLocale($lang);
       session()->put('locale', $lang);
   
       return redirect()->back();
   }

2. 在全局中间件中自动应用 Session 中的语言：
   创建中间件（如 SetLocaleMiddleware），并在 app/Http/Kernel.php 的 $middlewareGroups['web'] 中注册（确保在 StartSession::class 之后）：

   // app/Http/Middleware/SetLocaleMiddleware.php
   <?php
   
   namespace App\Http\Middleware;
   
   use Closure;
   use Illuminate\Http\Request;
   use Illuminate\Support\Facades\App;
   
   class SetLocaleMiddleware
   {
       public function handle(Request $request, Closure $next)
       {
           if (session()->has('locale')) {
               App::setLocale(session('locale'));
           }
           // 可选：fallback 到 config/app.php 中的 fallback_locale
           return $next($request);
       }
   }

   然后在 app/Http/Kernel.php 中注册：

   

   A1.art

   一个创新的AI艺术应用平台，旨在简化和普及艺术创作

   下载

   protected $middlewareGroups = [
       'web' => [
           // ... 其他中间件
           \App\Http\Middleware\StartSession::class,
           \App\Http\Middleware\SetLocaleMiddleware::class, // ← 放在 StartSession 之后
           // ...
       ],
   ];

3. （进阶）持久化至用户表（适用于登录用户）：
   若需跨设备/会话保持语言偏好，可在 User 模型中添加 locale 字段，并在登录后自动设置：

   // 登录后
   Auth::user()->update(['locale' => $lang]);
   App::setLocale(Auth::user()->locale ?? config('app.fallback_locale'));

⚠️ 注意事项：

• ✖️ 切勿在 HTTP 请求中调用 \Artisan::call()：它会触发完整的 Laravel 启动流程，阻塞响应、消耗资源，且无法生效于当前请求；
• ✅ App::setLocale() 仅作用于当前请求生命周期，因此必须配合 Session（或 Cookie/DB）实现“记忆”；
• ✅ JSON 文件格式应为标准键值对（无嵌套），例如 en.json：

  {
      "Welcome": "Welcome",
      "Logout": "Log Out"
  }

  对应视图中直接使用 {{ __('Welcome') }} 即可；

• ✅ 建议在 config/app.php 中设置 'fallback_locale' => 'en'，防止缺失翻译时降级显示。

通过以上方式，你就能实现零缓存干扰、高性能、可维护的 Laravel 8 多语言支持。