Phalcon 国际化 I18n，切换语言翻译文本缓存不刷新问题

Phalcon的I18n不支持运行时前端切换，语言在服务端请求时确定，刷新依赖重定向或新请求；需清APCu/OPcache、避免Translate单例复用、禁用Volt翻译缓存固化。

Phalcon 的 I18n 组件本身不内置运行时语言切换能力，它本质是服务端渲染型翻译工具——语言在请求进入时即确定，翻译结果在模板渲染阶段完成并输出 HTML。因此，“切换语言后翻译文本不刷新”不是前端状态同步问题，而是服务端缓存或配置未生效导致的静态内容滞留。

确认是否真在用 Phalcon 原生 I18n

Phalcon 4+ 已移除 Phalcon\Translate 的完整实现，官方推荐使用外部库（如 symfony/translation 或 i18next）配合 Phalcon 控制器。若你仍在用旧版 Phalcon\Translate\Adapter\NativeArray 或 Gettext：

• 检查是否启用了 APCu / OPcache 缓存翻译数组——修改语言文件后需手动清空 APCu 缓存：apcu_clear_cache('user')
• 确认翻译资源（PHP 数组或 .mo 文件）路径未被 OPcache 缓存：在 php.ini 中设置 opcache.enable_file_override=0 或重启 PHP-FPM
• 避免在 DI 容器中单例化 Translate 实例并复用——每次请求应基于当前语言新建实例，否则会复用上一次的翻译缓存

语言切换必须触发新请求

Phalcon 没有客户端响应式机制。所谓“切换语言”，只能通过以下任一方式实现：

• 重定向到带语言前缀的 URL（如 /zh/about → /en/about），并在路由或中间件中解析语言码，再传给 Translate 实例
• 提交表单或发 AJAX 请求到语言切换接口，该接口将语言存入 session 或 cookie，然后 return $this->response->redirect() 回原页
• 切勿尝试纯 JS 修改页面文本——Phalcon 渲染后的 HTML 是静态的，没有响应式数据绑定

避免翻译文本被模板引擎缓存

如果你用 Volt 模板且开启了编译缓存（view->setOptions(['compiledPath' => 'cache/volt'])）：

• Volt 编译后的 PHP 文件会固化翻译调用，例如 {{ t('welcome') }} 被编译为 echo $t->query('welcome')，但 $t 实例若未按请求语言重建，就仍用旧语言包
• 解决方案：在控制器中显式注入当前语言的 Translate 实例到视图：$this->view->t = new NativeArray(['locale' => $lang, 'content' => $messages]);
• 或改用函数式调用：{{ translate('welcome', lang) }}，并在 Volt 扩展中实现该函数，每次调用都读取最新语言包

调试关键点

在控制器中加日志验证实际生效的语言和翻译源：

• 打印 $this->request->getLanguage() 或从 URL/session 读取的语言码
• 打印 $translate->query('welcome') 返回值，确认是否为预期语言的文案
• 检查响应头 X-Phalcon-Language: zh 是否随切换更新，排除反向代理或 CDN 缓存干扰