ThinkPHP多语言需配置开关、建lang目录结构、用中间件设语言、域名映射及前端切换。先启用lang_switch_on，再按规范建zh-cn/common.php等，通过中间件提前调Lang::setLang()，结合域名映射与Session持久化实现动态切换。
如果您在ThinkPHP项目中需要为不同语言环境的用户提供对应界面文本，则必须通过多语言包配置与切换机制来动态加载对应语言的翻译资源。以下是实现此功能的具体步骤：
一、启用多语言开关并配置基础参数
该步骤用于激活框架的多语言能力，并设定默认行为逻辑。需修改应用配置文件以声明语言支持状态及初始策略。
1、打开config/app.php文件；
2、设置'lang_switch_on' => true，开启多语言切换功能；
立即学习“PHP免费学习笔记（深入）”；
3、指定默认语言，如'default_lang' => 'zh-cn'；
4、配置允许的语言列表，例如'allow_lang_list' => ['zh-cn', 'en-us', 'ja-jp']；
5、关闭URL参数自动识别以避免与域名切换冲突：'allow_url_lang' => false（若使用域名绑定方案）。
二、创建标准语言包目录结构
该步骤确保语言资源被框架正确识别和加载。ThinkPHP严格依赖约定路径与命名规范，任何偏差都将导致语言包静默失效。
1、在项目根目录下新建lang/文件夹；
2、按小写语言代码建立子目录，如lang/zh-cn/、lang/en-us/；
3、每个子目录内创建common.php文件，且必须返回PHP数组；
4、zh-cn/common.php必须写为return ['hello' => '你好'];，不可用JSON或大写命名如ZH-CN；
5、Linux服务器上注意区分大小写，zh-CN与zh-cn被视为完全不同语言码。
三、通过中间件实现请求级语言动态设置
该步骤保证语言切换在任何翻译调用前完成，是避免“已加载却未生效”问题的关键。必须在中间件中提前注入语言标识，而非控制器或模板中。
1、创建中间件app\common\middleware\Lang.php；
2、在handle()方法开头读取Session中的语言偏好：$lang = $request->session('lang', 'zh-cn');；
3、立即执行\think\Lang::setLang($lang)；
4、Lang::setLang()必须在lang()函数或模板{:lang()}调用之前执行，否则本次请求仍使用默认语言；
5、将该中间件注册至app/middleware.php全局中间件队列中。
四、使用域名自动映射语言包
该步骤适用于多语言站点采用独立子域部署的场景，如zh.example.com与en.example.com。需绕过框架默认探测逻辑，手动绑定域名与语言码。
1、在config/lang_domains.php中定义映射关系：['zh.example.com' => 'zh-cn', 'en.example.com' => 'en-us']；
2、在中间件handle()中解析$_SERVER['HTTP_HOST']，提取纯净域名（去除端口）；
3、根据域名查表获取对应语言码，并调用\think\Lang::setLang($matched_lang)；
4、禁止在控制器构造函数中设置语言，因中间件执行时机早于控制器实例化；
5、确保app.php中'allow_url_lang' => false已关闭，防止GET参数劫持语言判定。
五、前端触发语言切换并持久化选择
该步骤提供用户主动切换语言的交互入口，并将选择结果保存至服务端可读取的位置，确保跨请求一致性。
1、在HTML中添加语言切换按钮：<button onclick="switchLanguage('en-us')">English</button>；
2、编写JavaScript函数，向后端接口发送POST请求携带语言参数；
3、后端控制器接收后，将语言码存入Session：$this->request->session('lang', $lang)；
4、切换后必须刷新页面或重定向，因已加载的语言项不会自动更新；
5、模板中使用{:lang('hello')}或lang('hello')输出对应翻译内容。
