ThinkPHP多语言功能需配置开关、创建语言包、注册Lang中间件、支持URL/Cookie切换及统一调用接口。具体包括：启用lang_switch_on、设default_lang与lang_list；建app/lang/zh-cn等目录及common.php；注册Lang中间件；通过lang参数或Cookie切换；用lang()或{__('')}输出文本并支持占位符与复数。
如果您在ThinkPHP项目中需要为不同语言环境的用户提供对应界面文本，则必须通过多语言包配置机制来实现语言资源的组织与加载。以下是实现此功能的具体方法：
一、配置应用级多语言开关与默认参数
该方法通过修改核心配置文件启用多语言功能，并设定自动侦测行为、默认语言及允许切换的语言列表，为后续语言包加载提供基础运行条件。
1、打开 config/app.php 文件。
2、添加或确认以下配置项存在且值正确：
立即学习“PHP免费学习笔记（深入）”；
3、设置 'lang_switch_on' => true，表示开启语言包功能。
4、设置 'default_lang' => 'zh-cn'，指定未识别语言时的默认回退语言。
5、设置 'lang_list' => ['zh-cn', 'en-us', 'ja-jp']，以数组形式声明白名单语言标识。
6、可选设置 'var_language' => 'lang'，定义URL中用于手动切换的语言参数名（如 ?lang=en-us）。
二、创建标准语言包目录结构与文件
该方法依据ThinkPHP约定的路径规范存放语言包，确保框架能按优先级顺序自动定位并加载对应语言的键值映射。
1、在应用根目录下创建 app/lang/ 目录。
2、在 app/lang/ 下为每种语言创建子目录，命名须为小写连字符格式，例如：zh-cn、en-us、ja-jp。
3、在每个语言子目录中创建 common.php 文件。
4、在 zh-cn/common.php 中返回中文键值对，例如：return ['welcome' => '欢迎使用系统', 'logout' => '退出登录'];
5、在 en-us/common.php 中返回英文键值对，例如：return ['welcome' => 'Welcome to the system', 'logout' => 'Log out'];
6、确保所有语言包文件均以 return [ ... ]; 形式返回关联数组，且不嵌套语言代码层级。
三、注册Lang中间件以启用自动语言检测
该方法通过显式注册Lang中间件，使框架在请求生命周期早期完成语言环境判定与语言包加载，避免控制器中调用 lang() 时因未加载而返回原始键名。
1、打开 app/middleware.php 文件。
2、将 \think\middleware\Lang::class 添加至全局中间件数组中。
3、若仅需对特定路由组启用，可在路由定义中使用 ->middleware(\think\middleware\Lang::class) 显式绑定。
4、禁止在控制器构造函数中重复调用 Lang::detect()，该操作已由中间件完成。
5、确认未遗漏中间件注册——Lang中间件不会自动启用，未注册将导致语言包始终无法加载。
四、通过URL参数或Cookie手动切换当前语言
该方法允许用户通过链接点击或页面交互主动变更语言环境，并将选择持久化至客户端，供后续请求复用。
1、在任意链接中附加语言参数，例如：/index/index?lang=en-us。
2、在控制器中接收参数并校验是否在白名单内：$lang = input('lang'); if (in_array($lang, Lang::getAllowLangList())) { Lang::setLocale($lang); }
3、调用 \think\facade\Cookie::set('think_var', $lang, 3600) 将语言标识存入Cookie。
4、在模板中生成语言切换链接，例如：<a href="?lang=zh-cn">中文</a> <a href="?lang=en-us">English</a>
5、注意：Lang中间件默认仅从 Accept-Language 请求头或配置项读取语言，不自动解析 GET 参数，因此需配合 Lang::setLocale() 手动触发。
五、在代码与模板中安全调用多语言文本
该方法统一使用框架提供的语言获取接口，确保输出内容随当前语言环境动态变化，同时规避因键缺失导致的显示异常。
1、在控制器或模型中使用助手函数：lang('welcome') 或 __('logout')。
2、在模板文件中使用标签语法：{:lang('welcome')} 或 {__('logout')}。
3、支持占位符替换，例如语言包中定义 'hello_name' => '你好，{name}！'，调用时传入参数：lang('hello_name', ['name' => '张三'])。
4、支持复数规则，例如语言包中定义 'item|items'，调用 lang('item', 1) 返回左侧，其他数值返回右侧。
5、若键名不存在，lang() 默认返回原始键字符串，应确保语言包键名与调用处完全一致。
