直接用 gettext 是最轻量、最兼容、最不易出错的 php 国际化路径，因其自动处理复数、语序、工具链支持及 per-request 安全性，但需确保 php 启用扩展、locale 已安装、目录结构正确且文件编码为 utf-8。
PHP 实现国际化（i18n）不靠“教程式封装”，而靠选对机制 + 控制翻译域加载时机 —— 直接用 gettext 是最轻量、最兼容、最不易出错的路径，尤其在 Apache/Nginx + PHP-FPM 环境下。
为什么别急着写自己的语言包数组或 JSON 加载器
自己维护 $lang['welcome'] 或读取 zh_CN.json 看似简单，但很快会撞上这些实际问题：
- 复数形式（如英语 “1 file” / “2 files”）需手动判断，
gettext通过ngettext自动处理 - 词序依赖语种（如阿拉伯语动词在前、德语宾语常后置），硬编码字符串拼接会翻车
- 无法利用成熟工具链（
xgettext扫描源码提取词条、poedit协作翻译、msgfmt编译二进制.mo） - PHP 的
setlocale()是进程级，多线程/多请求下易被污染；gettext的bindtextdomain()+textdomain()是 per-request 安全的
启用 gettext 前必须确认的三件事
很多“不起作用”其实卡在这几步：
- PHP 编译时必须开启
--with-gettext（Ubuntu/Debian 装php-gettext包，CentOS/RHEL 装php-common，然后php -m | grep gettext确认输出gettext） -
.mo文件路径必须严格匹配：bindtextdomain('messages', '/var/www/locale')+ 语言目录结构为/var/www/locale/zh_CN/LC_MESSAGES/messages.mo（注意大小写、LC_MESSAGES固定名） - 调用
setlocale(LC_ALL, 'zh_CN.UTF-8')必须成功 —— 用locale -a | grep 'zh_CN'查系统是否装了该 locale，没装就运行locale-gen zh_CN.UTF-8并service locales restart
一个最小可运行的切换示例（不依赖框架）
核心是：每次请求开始时设置 locale 和 domain，而不是全局初始化一次：
// index.php
$lang = $_GET['lang'] ?? 'en_US';
$locale = match($lang) {
'zh' => 'zh_CN.UTF-8',
'ja' => 'ja_JP.UTF-8',
default => 'en_US.UTF-8',
};
// 必须先 setlocale，再 bindtextdomain，再 textdomain
setlocale(LC_ALL, $locale);
bindtextdomain('messages', __DIR__ . '/locale');
textdomain('messages');
echo _('Welcome'); // 自动按当前 locale 查 .mo
echo ngettext('File', 'Files', $count); // 复数支持
关键点：
-
_()是gettext()的别名，必须小写；ngettext()第三个参数是数字，决定用单数还是复数词条 - 不要在
gettext调用里拼接变量（如_("Hello " . $name)），所有占位符应走sprintf()分离：sprintf(_('Hello %s'), $name) - 如果页面部分区域需强制某语言（如后台日志固定英文），用
gettext('xxx')显式调用，避开_()
常见错误信息与对应解法
遇到这些提示，基本可定位到具体环节：
-
Warning: gettext(): No translation for "Welcome"→ 检查textdomain()名称是否和.mo文件名一致（不含路径和扩展名），且.mo已用msgfmt编译（不是直接改.po就完事） -
Notice: Undefined variable: _→ 说明gettext扩展未启用，_函数不存在，不是代码写错了 - 中文显示为 或乱码 →
setlocale()返回false（locale 未安装），或 PHP 文件本身不是 UTF-8 编码（.po/.mo 必须 UTF-8，PHP 源码也必须存为 UTF-8 无 BOM）
真正麻烦的从来不是“怎么切语言”，而是确保 gettext 的整个链条 —— 系统 locale、PHP 扩展、目录结构、文件编码、编译命令 —— 全部咬合。漏掉任意一环，都会静默失败。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
