ThinkPHP多语言怎么配服务_ThinkPHP伪静态依赖注入技巧【介绍】

在配置 ThinkPHP 多语言时，不少人会遇到一个奇怪的问题：伪静态 URL 明明写对了，但 lang 参数就是取不到。这背后其实涉及多个环节的配合——重写规则、中间件注册、语言包路径，缺一环都可能静默失败。下面把常见断点逐个拆开来讲。

先说结论：ThinkPHP 多语言配置本身不依赖伪静态，但两者在 URL 表现和请求处理上存在隐性耦合。伪静态规则若没有正确保留 lang 参数，或者干扰了 PATH_INFO 解析，就会导致 Lang::detect() 无法从 URL 获取 lang 值，语言切换自然失效。

lang 参数在伪静态下为什么取不到

ThinkPHP 默认通过 $_GET['lang'] 检测语言（前提是 lang_switch_on => true）。但伪静态重写后，原始查询参数可能被剥离或根本没有透传。问题往往出在下面几个地方：

• Apache 的 RewriteRule 必须带上 QSA（Query String Append）标志，比如 RewriteRule ^(.*)$ index.php/$1 [QSA,PT,L]。少了它，?lang=en-us 就会被直接丢弃。
• Nginx 的 try_files 指令里要显式拼接 $args：try_files $uri $uri/ /index.php?s=$uri&$args;。漏掉 $args 就等于丢弃所有 GET 参数。
• 如果用的是 PATH_INFO 模式的 index.php/ 格式，lang 必须作为独立参数传入，不能混在路径里。例如 /zh-cn/user/login 不会触发语言切换，必须写成 /user/login?lang=zh-cn 才行。

Lang 中间件注册后仍不生效的常见链路断点

Lang 中间件的执行时机早于控制器，但注册位置不对或加载顺序有误，Lang::setLang() 根本没机会在翻译前生效。排查时重点看这几项：

• 中间件是否放进了 app/middleware.php 的全局数组？只写在某个路由组里是没用的。
• 有没有其他自定义「URL 解析中间件」提前修改了 $request？如果有，后续 Lang::detect() 读到的 $_GET 可能已经不是原始值了。
• TP6+ 版本中，think\middleware\Lang 类默认只响应 Accept-Language 头部和配置项，并不自动解析 URL 参数。需要手动扩展——在中间件的 handle 方法里加一段逻辑：$lang = $request->param('lang', $request->session('lang', config('app.default_lang'))); \think\Lang::setLang($lang);
• 调用 Lang::setLang() 后要确保后续没有重复设置，否则后设的会覆盖前设的，白忙一场。

语言包路径和命名被忽略的硬性约束

ThinkPHP 对语言包路径、文件名、返回格式有严格约定，任何一项不符都会静默失败——不报错，只返回原 key 字符串。这一点最容易被忽视。几个关键规则：

• 语言包必须放在 app/lang/{lang}/common.php，其中 {lang} 是小写连字符格式（如 zh-cn），不是 zh_CN 或 ZH-CN。
• common.php 必须以 return ['key' => 'value']; 结尾。不能有 echo、print、BOM 头、多余空格或 JSON 格式。
• 模块级语言包路径为 app/module/lang/{lang}/common.php，优先级高于应用级。但模块名拼写必须与路由一致——比如 admin 模块不能写成 Admin。
• Linux 服务器上大小写敏感，lang/zh-cn/common.php 和 lang/ZH-CN/common.php 是两个不同的路径。

还有一个容易被忽略的点：语言包加载时机。Lang 中间件设完语言后，框架会自动加载对应语言包。但如果中间件里调用了 lang()，而此时语言包尚未完成加载（比如路径错、文件不存在），就会返回 key 名本身。线上环境默认不报错，排查起来特别头疼。建议上线前用脚本遍历所有 lang() 调用点，比对语言包键名完整性。