PHP多语言应优先选用gettext机制，需配置系统locale、启用扩展、规范目录结构并正确初始化；轻量级数组方案适用于小型项目，需注意复数、语序及内存管理。
PHP网站实现多语言，关键不在“怎么写翻译函数”，而在于选对机制、控好加载时机、避开常见陷阱。gettext是生产环境最稳的选择，但必须配齐系统locale、PHP扩展和目录结构；若受限于环境，轻量级PHP数组方案也能快速落地，只是要注意复数、词序和内存管理。
用 gettext 实现专业级多语言
这是适合中大型项目的方案，天然支持复数、上下文、工具链协作，且性能好、不易出错。
- 先确认系统已安装对应 locale：运行 locale -a | grep zh_CN.UTF-8（或 en_US.UTF-8、ja_JP.UTF-8），没结果就执行 sudo locale-gen zh_CN.UTF-8
- 确保 PHP 启用了 gettext 扩展：命令行运行 php -m | grep gettext，Web 环境还要检查 phpinfo() 输出
- 目录结构必须严格为：/locale/zh_CN.UTF-8/LC_MESSAGES/messages.mo（注意大小写、LC_MESSAGES 固定名、.UTF-8 后缀要与 setlocale 一致）
- 每次请求开始时按顺序调用：setlocale(LC_MESSAGES, $locale) → bindtextdomain('messages', __DIR__ . '/locale') → textdomain('messages')
- 代码中用 _() 替换字符串，用 ngettext('file', 'files', $n) 处理复数，避免硬拼接
用 PHP 数组文件快速启动
适合小型项目或测试环境，不依赖扩展，上手快，但需自行规避复数和语序问题。
- 在项目中建 lang/ 目录，放入 zh.php、en.php 等文件，每个返回关联数组，如：return ['welcome' => '欢迎', 'save' => '保存'];
- 根据 URL 参数（$_GET['lang']）、Accept-Language 头或 Session 决定当前语言，并只 require_once 对应文件
- 定义一个简单翻译函数：function t($key) { global $LANG; return $LANG[$key] ?? $key; }
- 模板中直接写 t('welcome')，避免全局加载所有语言包造成内存浪费
- 可加一层 APCu 或 $_SESSION 缓存数组，但注意 session 数据大小限制
语言检测与切换逻辑设计
用户看到什么语言，取决于你如何判断偏好，而不是你怎么存翻译。
立即学习“PHP免费学习笔记（深入）”；
- 检测优先级建议：URL 参数（如 ?lang=zh） > Accept-Language 请求头（用 Locale::acceptFromHttp($_SERVER['HTTP_ACCEPT_LANGUAGE']) 解析） > Session/ Cookie 中保存的历史选择 > 默认语言
- 语言标识要校验白名单，比如只允许 ['zh_CN.UTF-8', 'en_US.UTF-8', 'ja_JP.UTF-8']，防止路径遍历或无效 locale 导致 setlocale 失败
- 切换语言时，不能只改 Session 值，必须重新执行 locale 初始化三步，否则后续翻译不会变
- 生成语言切换链接时，保留当前页面路径，例如从 /product?id=123 切到英文版，应为 /product?lang=en&id=123
SEO 与前端协同要点
多语言不只是后端的事，搜索引擎和用户都需要清晰的语言信号。
- URL 结构推荐用路径前缀，如 /zh/about、/en/about，比 ?lang= 更利于 SEO
- 每个页面的 <head> 中加入 hreflang 标签，例如：<link rel="alternate" hreflang="zh-CN" href="https://example.com/zh/about">
- 前端需要翻译时，可将当前语言的键值对 JSON 化输出到页面，或通过 API 按需获取，避免重复维护两套翻译源
- 日期、数字、货币等本地化格式，不要依赖 gettext，改用 intl 扩展的 NumberFormatter 或 IntlDateFormatter
