ThinkPHP多语言怎么配还原_ThinkPHP伪静态灾难恢复技巧【介绍】-ThinkPHP-PHP中文网

多语言配置还原非回滚而是重置加载逻辑与文件结构；伪静态灾难常因重写规则误截lang参数，thinkphp对语言包路径、目录名（须全小写短横线如zh-cn）、文件名（须common.php）、return语法及lang::setlang执行时机（须在中间件中且早于任何lang()调用）极度敏感，且需确保伪静态规则保留$query_string或[qsa]。

thinkphp多语言怎么配还原_thinkphp伪静态灾难恢复技巧【介绍】

多语言配置还原不是“回滚”操作，而是重置语言加载逻辑和文件结构；伪静态灾难通常源于重写规则与语言参数冲突，比如 lang 变量被 Nginx/Apache 误截断或丢弃。

lang() 不生效？先查语言包路径和命名是否被框架忽略

ThinkPHP 对语言包位置、目录名、文件名极其敏感，错一个字符就静默失效，不报错也不提示。

语言包必须放在 app/lang/ 下（单应用）或 app/应用名/lang/（多应用），不能放 config/lang.php 或 runtime/lang/
子目录名必须全小写且用短横线，zh-cn ✅，zh_CN ❌，ZH-CN ❌，Linux 服务器上大小写错误直接找不到
文件名必须是 common.php（默认分组）或你显式指定的分组名（如 user.php），不能叫 zh.php 或 lang_zh.php
common.php 必须以 return ['key' => 'value']; 结尾，不能有输出、不能是 JSON/YAML、不能漏 return

切换语言后页面没变？检查 `Lang::setLang()` 的执行时机

ThinkPHP 不会自动根据 Cookie/Session 切换语言，Lang::setLang() 必须在任何 lang() 调用前执行，否则该请求全程用默认语言。

btpanel phpsite 宝塔面板PHP网站

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

下载

不要在控制器构造函数里设语言——中间件已执行完毕，翻译已缓存

必须在中间件中调用，例如 app\common\middleware\Lang.php：

public function handle($request, \Closure $next) {
    $lang = $request->session('lang', config('app.default_lang'));
    \think\Lang::setLang($lang);
    return $next($request);
}

确认中间件已注册：在 app/middleware.php 中包含 'think\middleware\LoadLangPack'（TP6/TP8）或自定义中间件
TP8 多应用模式下，MultiApp.php 会重复加载默认语言包，需注释掉其中的 $this->app->loadLangPack(...) 行

伪静态开启后 ?lang=en-us 失效？重写规则可能吞掉了 GET 参数

Apache/Nginx 开启伪静态后，lang 参数常因重写规则未显式保留而丢失，导致自动探测 fallback 到默认语言。

Apache 用户检查 .htaccess，确保重写规则末尾带 [QSA]（Query String Append）：
```
RewriteRule ^(.*)$ index.php?/$1 [QSA,PT,L]
```
Nginx 用户检查 location 块，try_files 后必须带 $args：
```
try_files $uri $uri/ /index.php?$args;
```
避免把 lang 当作路由变量处理，例如不要写成 route_rule => 'lang/:lang' ，这会让框架误认为它是模块/控制器名
调试时临时关闭伪静态，用 index.php?lang=en-us 验证语言切换是否底层正常

还原多语言配置最稳妥的三步

别依赖“一键还原”，ThinkPHP 多语言的脆弱点在于路径、时机、规则三者耦合，手动清理反而更可控。

删掉所有 runtime/lang/ 缓存文件（TP6/TP8 默认缓存语言包）
把 app/lang/ 下语言目录重命名为 lang_bak/，新建标准结构：app/lang/zh-cn/common.php 和 app/lang/en-us/common.php，各写一行 return ['test' => 'ok'];
清空浏览器 Cookie（特别是 think_lang）、禁用浏览器插件干扰，再用 ?lang=en-us 直接测试