如何实现ThinkPHP多语言支持以适配小程序国际化？

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

ThinkPHP 是一款流行的 PHP 开源框架，它简化了 PHP 开发，提高了开发效率。以下是其基本功能和特点：

小程序请求必须带 lang 参数或自定义 header

小程序 wx.request 默认不会携带语言信息，服务端无法靠 $_SERVER['HTTP_ACCEPT_LANGUAGE'] 自动识别。必须在每次请求中明确传递：

• 推荐方式：URL 查询参数，如 /api/user?lang=zh-cn 或 /api/user?lang=en-us
• 备选方式：自定义 header，如 lang: zh-cn，后端用 input('server.HTTP_LANG') 读取
• 避免用 storage 存语言再拼 URL —— 请求失败时 lang 可能丢失，导致接口返回默认语言文案

Lang::setLocale() 必须在中间件里提前调用

ThinkPHP 的语言切换不是“全局变量赋值”，而是一次性初始化动作。如果在控制器里才调用 Lang::setLocale()，模板渲染或验证规则可能已按默认语言执行完毕。