ThinkPHP多语言自动侦测核心是按GET参数→Cookie→Header→HTTP_ACCEPT_LANGUAGE顺序识别语言，并通过Lang::detect()或LoadLangPack中间件触发；需配置switch_on、allow_lang_list、detect_var、use_cookie等参数并确保语言包路径正确。
ThinkPHP 实现多语言自动侦测，核心是让系统根据用户环境（如 URL 参数、Cookie、浏览器 Accept-Language）自动识别并加载对应语言包。配置本身不复杂，但需注意版本差异和行为/中间件的启用顺序。
基础配置项（适用于 TP5/TP6）
在项目配置文件（如 config/app.php 或 config/lang.php）中设置以下关键参数：
-
开启多语言开关：
'lang_switch_on' => true（TP5）或'switch_on' => true（TP6） -
启用自动侦测：
'lang_auto_detect' => true（TP5），TP6 中默认启用，也可显式设为true -
指定允许语言列表：如
'lang_list' => ['zh-cn', 'en-us']（TP5）或'allow_lang_list' => ['zh-cn', 'en-us']（TP6） -
设置侦测变量名：如
'var_language' => 'lang'，这样访问?lang=en-us就能手动切换 -
默认语言：如
'default_lang' => 'zh-cn'，当所有侦测方式都失败时回退至此 -
启用 Cookie 记忆：TP6 推荐设
'use_cookie' => true和'cookie_var' => 'think_lang'；TP5 可通过Cookie::set()在逻辑中自行处理
确保侦测逻辑被执行
自动侦测不是配完就生效，还需触发执行：
-
TP5：需在行为（Behavior）中调用
\think\Lang::detect()。常见做法是在common.php或模块初始化文件末尾添加该调用 -
TP6：推荐使用中间件。在
app/middleware.php中注册think\middleware\LoadLangPack，它会自动完成侦测与加载 - 若自定义逻辑（如优先读 Cookie、再读 URL、最后看浏览器头），可在应用初始化或前置中间件中手动调用
Lang::detect()，并提前设置好侦测变量和允许列表
语言包路径与加载优先级
系统按以下顺序查找并合并语言变量，后加载的覆盖先加载的：
立即学习“PHP免费学习笔记（深入）”；
- 框架级：
thinkphp/lang/zh-cn.php - 应用级：
app/lang/zh-cn.php - 模块级：
app/index/lang/zh-cn.php - 控制器级：
app/index/lang/zh-cn/index.php（仅 TP5 支持）
确保对应语言代码的 PHP 文件存在且返回关联数组，例如 zh-cn.php 内容应为：<?php return ['hello' => '你好'];
浏览器语言侦测原理
自动侦测主要依赖 $_SERVER['HTTP_ACCEPT_LANGUAGE']，例如值为 zh-CN,zh;q=0.9,en-US;q=0.8,en;q=0.7 时，系统取第一个有效项 zh-cn（转小写并标准化格式）。该值由浏览器发送，用户可在浏览器设置中修改语言偏好。
若 URL 中带 ?lang=en-us，且该语言在 allow_lang_list 中，则直接采用并写入 Cookie（如果启用了 Cookie 记忆），后续请求将沿用该选择，无需重复传参。
