如何配置ThinkPHP多语言API以适配伪静态接口？

本文共计1079个文字，预计阅读时间需要5分钟。

ThinkPHP 是一款流行的 PHP 开源框架，它简化了 PHP 开发流程，提高了开发效率。该框架遵循 MVC 架构模式，具有以下特点：

API 请求里怎么指定语言

前端应在请求头中携带 Accept-Language，或统一用自定义 Header，比如 X-Language: en-us。框架默认只认 Accept-Language，但该字段浏览器自动带、API 客户端未必可控，所以更推荐显式 Header。

• 后端需在中间件中提前读取并设置语言，不能等控制器才处理，否则 lang() 已按默认语言渲染完毕
• 不要依赖 Lang::setLang() 在控制器里调用——它只影响后续调用，对当前请求中已初始化的语言包无效
• 若用 Accept-Language，注意 ThinkPHP 的解析逻辑只取第一个匹配项（如 zh-CN,zh;q=0.9,en-US;q=0.8 只取 zh-cn），且严格比对 LANG_LIST 中的值（zh-cn ≠ zh_CN）

lang/ 目录结构和命名必须严格匹配

API 场景下语言包仍须放在 lang/ 下，子目录名必须小写、用短横线分隔（zh-cn、en-us），不能是下划线或大写；文件名固定为 common.php 或按分组命名（如 api.php），但必须在调用前显式加载。