ThinkPHP多语言怎样适配API_ThinkPHP接口多语言返回配置【教程】-ThinkPHP-PHP中文网

thinkphp api多语言需显式设置语言上下文并统一错误码与语言键：通过lang参数、请求头或中间件设语言，严格遵循lang包路径/命名规则，配合error_code配置实现提示文本动态切换。

thinkphp多语言怎样适配api_thinkphp接口多语言返回配置【教程】

ThinkPHP 的多语言在 API 场景下不能直接套用模板渲染那一套，lang() 函数本身可用，但关键在于「语言上下文如何确定」和「错误码/提示文本是否走同一套机制」——这两点不处理好，API 返回的中文提示就永远切不到英文。

API 请求里怎么让 lang() 知道该用哪门语言

ThinkPHP 默认靠 GET 参数、Cookie、Accept-Language 头三级 fallback 判断语言，但纯 API（尤其前后端分离）往往不带 Cookie，也不走浏览器自动头解析。这时候必须显式干预。

确保 config/lang.php 中启用了 'lang_detect_var' => 'lang'（或你自定义的参数名），否则 ?lang=en-us 不生效
如果前端用 Authorization + JSON body，GET 参数不可靠，就得在中间件里手动设语言：
```
use think\facade\Lang;
Lang::setLang($request->header('X-Language', 'zh-cn'));
```
Accept-Language 解析默认只认 zh-CN → zh-cn 映射，若前端传 zh-Hans，得在 config/lang.php 的 'accept_language' 配置里补上：'zh-hans' => 'zh-cn'

lang() 在 JSON 接口里返回乱码或空字符串

常见不是函数问题，而是语言包没加载或路径错位。ThinkPHP6+ 的 lang/ 目录位置和命名规则比 ThinkPHP5 更严格。

btpanel phpsite 宝塔面板PHP网站

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

下载

语言包必须放在 app/lang/zh-cn.php（单应用）或 app/api/lang/zh-cn.php（模块化），不能放 config/lang.php 里
文件名必须全小写、用短横线，zh_CN.php 或 en_US.php 会被完全忽略，不报错也不加载
每个语言文件必须 return 一个数组，且不能有 BOM 头 —— Windows 编辑器保存时选「UTF-8 无 BOM」
如果用了分组（如 user.php），调用时得写 lang('user.login_failed')，而不是只写 lang('login_failed')

错误码统一管理 + 多语言提示怎么串起来

直接在控制器里写 lang('user_not_found') 可以，但不利于维护。推荐把错误码和语言键解耦：

建 config/error_code.php，内容类似：

return [
    'USER_NOT_FOUND' => 1001,
    'INVALID_TOKEN'  => 1002,
];

建 lang/zh-cn.php 和 lang/en-us.php，都包含：

return [
    'USER_NOT_FOUND' => '用户不存在',
    'INVALID_TOKEN'  => '令牌无效',
];

封装响应函数时，用 lang($code) 替代硬编码：

function api_fail(string $code, array $data = []): array {
    return [
        'code' => config('error_code')[$code] ?? 500,
        'msg'  => lang($code),
        'data' => $data,
    ];
}

最易被忽略的是：语言包加载时机。如果在中间件里调 Lang::setLang() 太晚（比如在控制器之后），lang() 已经用默认语言执行过了。务必把语言设置逻辑放在 LoadLangPack 中间件之前，或自己注册一个高优先级中间件。