PHP多语言支持通过gettext/intl扩展、语言包管理及请求上下文识别实现：需启用gettext扩展（Linux/macOS取消php.ini中extension=gettext注释并重启服务），正确配置setlocale、bindtextdomain和textdomain，或用数组映射+session/GET参数快速适配小项目。
PHP 多语言支持不是靠“学一门新语言”实现的，而是用现有 PHP 能力把同一套逻辑适配不同语言环境。核心在于：gettext 或 intl 扩展 + 语言包管理 + 请求上下文识别，三者缺一不可。
怎么启用 PHP 的 gettext 支持（Linux/macOS 常见失败点）
很多本地环境（如 XAMPP、ServBay）默认不开启 gettext，gettext() 函数直接报错 Call to undefined function gettext()。
- 先确认扩展是否加载：
php -m | grep gettext；没输出就说明没启用 - Linux 下编辑
/etc/php/*/apache2/php.ini（或 CLI 对应的php.ini），取消注释这行：;extension=gettext→ 改成extension=gettext - macOS 用 Homebrew 安装 PHP 时，
gettext是独立扩展包，需额外执行：brew install php-gettext，再在php.ini中加extension=php_gettext.so - Windows 用户注意：
php_gettext.dll文件必须存在于ext/目录，且php.ini中写的是extension=php_gettext.dll（不是.so） - 改完重启 Apache/Nginx，用
phpinfo()页面搜索 “gettext” 确认模块已加载
gettext 的实际调用流程为什么总返回英文？
常见现象是代码写了 echo gettext('Save')，但页面始终显示 'Save' 而非翻译后的中文——这不是函数没生效，而是语言域（domain）、路径、区域设置（locale）三者没对齐。
-
setlocale(LC_ALL, 'zh_CN.UTF-8')必须在bindtextdomain()之前调用，且系统必须真实安装该 locale（locale -a | grep zh_CN查看） -
bindtextdomain('messages', '/path/to/locales')的第二个参数必须是zh_CN/LC_MESSAGES/messages.mo所在的父目录（即/path/to/locales），不是.mo文件本身 -
textdomain('messages')的 domain 名必须和.po/.mo文件名完全一致（区分大小写） - Linux 下若 locale 不存在，可临时生成：
sudo locale-gen zh_CN.UTF-8 && sudo update-locale
不用 gettext 怎么快速做多语言（适合小项目/原型）
如果只是管理几十条文案，又不想折腾 locale 和编译 .mo，用数组映射 + $_SESSION 或 $_GET['lang'] 更轻量。
立即学习“PHP免费学习笔记（深入）”；
- 语言包结构建议用 PHP 数组而非 JSON：
zh.php直接return ['home' => '首页', 'save' => '保存'];，避免 JSON 解码开销 - 加载逻辑别写死：
$lang = $_GET['lang'] ?? ($_SESSION['lang'] ?? 'en');，再include "lang/{$lang}.php" - 关键要过滤输入：
in_array($lang, ['en', 'zh', 'ja'], true)，防止路径遍历（如?lang=../../etc/passwd） - 浏览器语言解析慎用：
$_SERVER['HTTP_ACCEPT_LANGUAGE']返回的是逗号分隔字符串（如zh-CN,zh;q=0.9,en;q=0.8），需手动解析优先级，不能直接substr取前两位
intl 扩展的 MessageFormatter 适合什么场景？
当文案含变量（如 “用户 {name} 已登录 {time} 分钟”），且变量顺序在不同语言中会变化（比如阿拉伯语把时间放前面），硬拼接字符串会出问题。MessageFormatter 就是为这种场景设计的。
- 必须确保
intl扩展已启用（php -m | grep intl），且 ICU 数据库版本 ≥ 60（老系统如 CentOS 7 默认 ICU 50，MessageFormatter::formatMessage('ar', ...)会静默失败） - 格式字符串用占位符：
{name} logged in {time, number} minutes ago，不是$name . ' logged in ' . $time - 传参必须是关联数组：
MessageFormatter::formatMessage('zh', $pattern, ['name' => '张三', 'time' => 5]) - 注意性能：每次 new MessageFormatter 开销较大，建议按 locale 缓存实例，或用
MessageFormatter::formatMessage()静态方法
真正卡住人的往往不是语法，而是 locale 系统依赖、文件编码（.po 必须 UTF-8 无 BOM）、以及 Apache 的 AcceptLanguage 模块是否启用——这些底层链路断了，上层代码再对也没用。
