RESTful接口需在beforeAction()中显式提取Accept-Language或lang参数并设Yii::$app->language，同步调用Yii::$app->i18n->setLanguage()，且确保intl扩展启用、翻译文件路径正确、category匹配。
RESTful 接口本身不自动读取或设置 Yii::$app->language，必须显式从请求中提取语言标识并手动赋值，否则 Yii::t()、Formatter（如日期/数字格式）、验证器错误信息等仍按默认语言渲染。
怎么从 REST 请求里安全提取 language 值
REST 接口通常不走前端路由规则，也不依赖美化 URL 的路径段（如 /zh-CN/v1/users），所以不能靠 UrlManager 解析首段。常见可靠来源只有三个：HTTP 头 Accept-Language、请求参数（?lang=ja-JP）、或认证后用户 profile 字段。
-
Accept-Language是最标准的依据，但需解析优先级和匹配精度（如zh-CN;q=0.9, zh;q=0.8），建议用yii\helpers\StringHelper::basename()或正则粗筛主语言码，避免直接信任完整值 - 显式
lang参数仅在调试或客户端强控时使用，上线后应校验其是否在白名单内（如['en-US', 'zh-CN', 'ja-JP']），防止任意字符串污染Yii::$app->language - 若接口已鉴权且用户表存有
preferred_language字段，应以该字段为准，它比请求头更符合用户真实偏好 - 绝不要 fallback 到
$_SERVER['HTTP_ACCEPT_LANGUAGE']原始字符串——未解析时可能含空格、非法字符，直接赋值会导致Formatter初始化失败或静默降级
在哪里设置 Yii::$app->language 才有效
必须在控制器动作执行前完成赋值，否则 Validator、ActiveRecord::scenarios()、Formatter 初始化都已完成，再改 language 也无效。REST 场景下，beforeAction() 是唯一合理位置，但要注意它对所有动作生效，需排除 OPTIONS 预检请求。
- 在基控制器（如
ActiveController子类）重写beforeAction()，先调用parent::beforeAction($action)，再提取并设置语言 - 跳过
$action->id === 'options'，避免预检请求触发无意义的语言初始化 - 设置后立即调用
Yii::$app->i18n->setLanguage(Yii::$app->language)，确保翻译组件同步更新（尤其当i18n组件被延迟加载时） - 不要在
init()里设——此时Request对象可能还未完全绑定，get()或getHeaders()可能返回空
为什么 Yii::t() 在 API 返回里还是英文
常见原因是翻译文件没加载或 category 不匹配，而非语言设置失败。REST 接口常忽略视图层，容易漏掉 i18n 组件配置或消息源路径错误。
- 检查
config/web.php中i18n组件是否注册，且sourceLanguage明确设为'en-US'（别用zh-CN作源语言，否则翻译逻辑反转） - 确认翻译文件路径正确：
@app/messages/zh-CN/app.php对应Yii::t('app', 'Save')，category 名必须与文件名一致，大小写敏感 - 运行
./yii message/extract后，清空runtime/i18n缓存目录——缓存会记住旧的 category 映射，改了文件也不生效 - 如果用
JsonResponseFormatter，确保它不干扰Yii::t()调用；错误信息来自模型验证时，要检查ActiveRecord::attributeLabels()是否也用了Yii::t()
Formatter 日期/数字格式没随 language 变
Formatter 依赖 ICU 数据库驱动本地化格式，光设 Yii::$app->language 不够，还必须确保 PHP 启用了 intl 扩展，且 ICU 版本支持目标语言。
- 执行
php -m | grep intl确认扩展已启用；若无输出，需安装php-intl并重启 Web 服务 - 检查
Yii::$app->formatter->locale是否等于Yii::$app->language，默认情况下它会自动同步，但若你在某处手动设过formatter->locale，就会覆盖自动同步 - ICU 不支持某些小众 locale（如
zh-Hans），应优先使用标准码如zh-CN；可用Locale::acceptFromHttp()测试是否被 ICU 识别 - API 返回 JSON 时，
DateTime对象经JsonSerializer处理，其格式由formatter->datetimeFormat控制，这个属性是字符串模板，不是 locale——真正起作用的是formatter->locale和底层 ICU
最易被忽略的一点：REST 接口常绕过 View 组件，导致 Formatter 的 locale 初始化时机错乱。如果你在 beforeAction() 里设置了 language，但没显式触发 Yii::$app->formatter->init()，部分格式方法（尤其是首次调用）可能仍用默认 locale。这不是 bug，而是 Yii 的 lazy-init 设计使然。
