微盘源码多语言如何配置？

在微盘源码的商业化落地过程中，语言壁垒常常是制约用户增长的隐形拦路虎。把系统的文字抽离出来、交由配置文件统一管理，往往比硬编码更能适配跨境业务的快速迭代。

多语言目录结构的约定

官方推荐在项目根目录新建 resources/lang，每种语言对应一个子目录，例如 zh_CN、en_US、vi_VN。子目录里放置以功能模块命名的 PHP 数组文件，键是标识符，值是对应语言的文本。

• zh_CN/common.php —— 通用按钮、提示语
• en_US/common.php —— 同上英文版
• vi_VN/common.php —— 越南语翻译文件

核心配置文件的关键字段

// config/app.php
'locale'        => env('APP_LOCALE', 'zh_CN'), // 默认语言
'fallback_locale'=> 'en_US',                // 兜底语言
'available_locales' => ['zh_CN','en_US','vi_VN'], // 支持列表

把上述字段写进 .env，比如 APP_LOCALE=zh_CN，即可让框架在启动时自动加载对应语言包。若用户在前端切换语言，只需将 locale 写入 Session，随后每次请求都能读取并覆盖默认值。

前后台语言切换的实现路径

后台管理系统的语言切换按钮往往位于右上角的下拉菜单。实现思路是：点击后触发 Ajax 请求，把选中的语言码写入 session('locale')，随后通过中间件 LocaleMiddleware 把 Session 中的值写回 App::setLocale()。前台页面同理，只是把语言码保存在 Cookie，兼容游客访问。

• 在 app/Http/Middleware/LocaleMiddleware.php 中加入 App::setLocale(session('locale', config('app.locale')));
• 前端语言切换组件使用 fetch('/locale?lang=en_US')，后端返回 200 即可刷新页面。

实战中发现，把语言标识写进 URL（如 /en_US/dashboard）可以让搜索引擎直接抓取多语言页面，SEO 效果意外惊喜。

配置完毕后，打开后台的语言下拉，切到 English，用户列表、订单管理、系统通知全都换成英文；换回中文，所有文字瞬间恢复。若要新增法语，只需在 resources/lang 里建 fr_FR 文件夹，复制一份 common.php，填入翻译，config/app.php 的 available_locales 中加上 'fr_FR'，其余流程无需改动。