PHP应在页面初始化时用json_encode安全注入语言包至window.i18nData，JS通过data-i18n属性批量更新文本并触发i18n:changed事件，同时需同步localStorage与PHP session以保证首屏语言和SEO一致。
PHP 生成语言配置后，JS 怎么读取并生效
PHP 不负责前端语言切换的实时逻辑，它只该干一件事：在页面初始化时，把当前用户应使用的语言包（比如 zh_CN 或 en_US）和对应翻译数据，以安全、可被 JS 消费的方式注入到 HTML 中。常见错误是 PHP 直接 echo 一堆 JS 变量，结果引号没转义、JSON 结构不合法，导致 Uncaught SyntaxError。
- 推荐做法：用
json_encode()输出翻译键值对，并包裹在<script>标签里，设置type="application/json"或直接赋给全局变量（如window.i18nData） - 别把整个语言包塞进
<meta>或data-属性——长度受限、解析麻烦、易 XSS - 注意
json_encode()的第二个参数：加上JSON_UNESCAPED_UNICODE | JSON_HEX_TAG，避免中文被转成 \uXXXX，也防止<被编码成 \u003c 导致后续 DOM 解析异常
JS 切换语言时，DOM 文本怎么批量更新
靠手动遍历所有 innerText 并替换？太脆弱。核心是建立“文本节点 ↔ 翻译 key”的映射关系，而不是依赖 class 名或属性名硬编码。
- 在 HTML 中用
data-i18n="login.title"标记需要翻译的元素，JS 批量查出所有带该属性的节点，再用 key 去查i18nData对象 - 不要用
innerHTML直接写入——会清空事件监听器、破坏富文本结构；优先用textContent，对含 HTML 的字段（如带链接的提示语），单独处理并做白名单过滤 - 切换语言后，记得触发自定义事件（如
dispatchEvent(new Event('i18n:changed'))），让 Vue/React 组件或表单验证等模块能响应更新
切换语言后，如何持久化用户偏好并同步到 PHP 后端
仅存 localStorage 是不够的。用户下次直连 PHP 页面时，PHP 还得知道该用哪种语言渲染初始 HTML —— 否则出现“闪动”（先英文再变中文）或 SEO 语言错乱。
- 前端切换语言时，除了写
localStorage.setItem('lang', 'ja')，必须发一次轻量请求（如fetch('/api/set-lang?lang=ja', {method: 'POST'})）告诉 PHP 记住这个选择 - PHP 端收到请求后，应把语言存到 session 或用户表字段（非 cookie！cookie 易被篡改且长度有限），并在后续响应头中设置
Vary: Cookie避免 CDN 缓存混用 - 下次 PHP 渲染页面前，先检查 session / 用户配置，再决定用哪个语言包生成初始
i18nData，而不是只看Accept-Language请求头
为什么不能只靠 JS 做国际化，而要 PHP 配合
因为首次加载的 HTML 必须包含正确语言的文本。纯 JS 切换只能改已存在的 DOM，但 meta 描述、title、SEO 关键字、Open Graph 标签这些，都由 PHP 渲染决定。如果 PHP 默认输出英文，JS 再怎么切，搜索引擎看到的仍是英文。
立即学习“PHP免费学习笔记（深入）”；
- PHP 负责「首屏语言」和「服务端可感知的语言上下文」；JS 负责「交互态语言切换」和「局部刷新」
- 一个典型坑：用 JS 改了
document.title，但 PHP 没同步更新<title>标签内容，导致分享到微信时显示旧语言 - 更隐蔽的问题：表单提交失败后，PHP 返回的错误提示是服务端语言，若前后端语言不一致，用户会看到“Password is required” 和 “密码不能为空” 同时存在
真正难的不是切换动作本身，而是让 PHP 和 JS 在语言状态上始终对齐——session、localStorage、URL 参数、HTTP 头，四者稍有不同步，就会漏翻、错翻、闪退。
