ThinkPHP 8.2安装后如何配置多语言？-ThinkPHP-PHP中文网

thinkphp 8.2 多语言需手动注册路径、设默认语言并显式调用翻译函数，否则返回空或原键名；须在 config/app.php 配置 lang_path、default_lang 和 support_lang，语言包按 iso 639-1 命名，置于指定目录并确保 runtime/lang/ 可写。

thinkphp 8.2安装后如何配置多语言？

ThinkPHP 8.2 的多语言不是靠「启用某个开关」就生效的，必须手动注册语言包路径、设置默认语言、并在控制器/模板中显式调用 lang() 或 __()，否则所有翻译函数返回空字符串或原始键名。

确认语言包目录结构和加载路径

TP8.2 默认不自动扫描语言文件，必须在 config/app.php 中明确声明 lang_path 和支持的语言列表。常见错误是把语言包放在 app/lang/zh-cn/ 却没告诉框架去哪找。

语言包应按 ISO 639-1 标准命名子目录，如 zh-cn、en-us、ja-jp，每个目录下放 message.php（数组返回键值对）

在 config/app.php 中补全配置：

'lang_path' => app_path() . 'lang' . DIRECTORY_SEPARATOR,
'default_lang' => 'zh-cn',
'support_lang' => ['zh-cn', 'en-us', 'ja-jp'],

若语言包放在 runtime/lang/ 或自定义路径，lang_path 必须是绝对路径，且 Web 进程有读取权限

在控制器中切换语言并验证是否生效

TP8.2 的语言切换不依赖 Cookie 或 Session 自动识别，必须主动调用 think\facade\Lang::setLocale()，且该调用需早于任何 lang() 调用，否则缓存已生成，切换无效。

btpanel phpsite 宝塔面板PHP网站

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

下载

在控制器构造函数或前置中间件中设置：
```
use think\facade\Lang;
Lang::setLocale('en-us');
```
切勿在视图里用 Lang::setLocale()，因为模板渲染时语言环境已冻结
验证是否加载成功：在控制器中加一行 dump(Lang::has('user.login'));，返回 true 表示键存在；若为 false，检查 message.php 是否返回数组、键名是否拼写一致、文件编码是否为 UTF-8 无 BOM

模板中使用 __() 函数的注意事项

__() 是 TP8.2 的快捷翻译函数，但它不支持动态变量拼接——比如 __('Hello %s', $name) 在 8.2 中会直接输出原始字符串，而非替换。

正确写法是用 sprintf() 手动包裹：
```
= sprintf(__('Hello %s'), $name) ?>
```
若启用了多语言路由（如 /en-us/login），需配合 Route::domain() 或中间件提取语言段，并在请求生命周期早期完成 Lang::setLocale()
避免在 config/ 文件中直接调用 __()，因为配置加载早于语言环境初始化，必然返回空

最易被忽略的是：TP8.2 的语言缓存默认写入 runtime/lang/，但该目录若不可写，__() 会静默失败且不报错——务必确认 runtime/lang/ 存在且 Web 进程有写权限，否则每次请求都重新解析 PHP 文件，性能断崖下跌。