ThinkPHP如何自动检测语言_ThinkPHP多语言自动切换设置指南【方法】-ThinkPHP-PHP中文网

thinkphp自动检测浏览器语言需显式开启lang_switch_on配置并注册app_begin行为钩子，否则lang::detect()不执行；其解析accept-language取首标签转小写，仅在allow_lang_list中才生效；优先级为get参数>cookie>默认值>http_accept_language。

thinkphp如何自动检测语言_thinkphp多语言自动切换设置指南【方法】

ThinkPHP 能自动检测浏览器语言，但默认不启用，必须显式开启配置并确保行为钩子注册正确，否则 Lang::detect() 不会执行。

如何开启自动检测并让 detect() 生效

自动检测不是开个开关就完事的——它依赖 app_begin 行为触发，且只在 lang_switch_on 为 true 时才运行。常见错误是只改了配置却没加行为定义。

config/lang.php 中必须设置 'lang_switch_on' => true（TP6）或 'LANG_SWITCH_ON' => true（TP5/3.2）
TP6：确保 middleware.php 包含 'think\middleware\LoadLangPack'
TP5：在 tags.php 的 app_begin 数组里加入 'Behavior\CheckLangBehavior'（类名注意大小写）
TP3.2：同样在 tags.php 加 'Behavior\CheckLangBehavior'，且确认该类文件存在路径 ThinkPHP/Extend/Behavior/CheckLangBehavior.class.php

浏览器 Accept-Language 怎么被解析

Lang::detect() 内部用 preg_match('/^([a-z\d\-]+)/i', $_SERVER['HTTP_ACCEPT_LANGUAGE'], $matches) 提取第一个语言标签，比如 zh-CN,zh;q=0.9,en;q=0.8 → zh-cn（转小写后）。但这个结果必须在允许列表里才生效。

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

务必通过 Lang::setAllowLangList(['zh-cn', 'en-us']) 或配置项 allow_lang_list / LANG_LIST 显式声明支持哪些语言
如果浏览器发来 ja-JP，而你没在允许列表中写 ja-jp，系统会 fallback 到 default_lang，不会报错也不会提示
权重（q=0.9）不参与匹配逻辑，只取第一个非空语言片段

URL 参数和 Cookie 优先级怎么排

TP5/TP6 的 detect() 方法有固定顺序：GET 参数 > Cookie > 默认值 > HTTP_ACCEPT_LANGUAGE。但要注意 Cookie 名和有效期由框架控制，不能随意改。

GET 参数键名由 detect_var（TP6）或 VAR_LANGUAGE（TP5/3.2）决定，默认是 lang，即访问 ?lang=en-us
Cookie 名在 TP6 是 cookie_var（默认 think_lang），TP5 是 think_language；手动设 Cookie 必须用对应 key，否则检测不到
Cookie 过期时间硬编码为 3600 秒（1 小时），TP5 源码里写死，无法通过配置修改
如果 GET 和 Cookie 同时存在且冲突，GET 始终胜出——这点常被忽略，导致“切了语言又变回去”

语言包加载失败的典型表现和排查点

页面没报错但文字仍是英文或乱码，大概率是语言包根本没加载成功。最隐蔽的问题是路径和命名不一致。

TP6：语言包必须放在 app_name/lang/{lang}.php，例如 app_name/lang/zh-cn.php，文件名必须全小写、带短横线
TP5：支持多级路径，如 application/lang/zh-cn.php（应用级）、application/index/lang/zh-cn.php（模块级），但模块级需额外调用 Lang::load()
返回数组的键名必须是字符串，不能是中文或特殊符号；值可以是中文，但整个文件必须是 UTF-8 无 BOM 编码
用 Lang::get('hello') 测试时，如果返回空字符串，先 dump Lang::range() 看当前生效的语言是否是你预期的值