SSH执行PHP脚本时Gettext非根语言Fallback至英文问题

问题核心 #

通过SSH执行PHP多语言脚本时，尽管LC_ALL和setlocale设置成功，但非根语言的翻译始终 fallback 到en_GB，而本地脚本或HTTP请求执行时一切正常。

可能原因 #

SSH会话默认携带的环境变量（如LANG）会优先于PHP中通过putenv设置的LC_ALL，导致gettext加载了系统默认的en_GB翻译；此外，未指定完整带编码的locale名称，也可能导致无法匹配到正确的.mo文件。

解决步骤 #

1. 强制覆盖所有locale相关环境变量 #

在PHP脚本中先清除可能存在的干扰变量，再设置目标locale（需带编码）：

// 清除系统默认的locale环境变量
putenv('LANG=');
putenv('LC_ALL=');
putenv('LC_MESSAGES=');

// 设置完整带编码的目标locale
putenv('LC_ALL=de_DE.UTF-8');
// 同时指定带编码的locale参数，确保setlocale生效
setlocale(LC_ALL, 'de_DE.UTF-8', 'de_DE');

2. 确认服务器已安装完整locale版本 #

在服务器上执行locale -a，检查是否存在目标locale的完整编码版本（如de_DE.UTF-8）。若缺失，需安装对应locale：

# Debian/Ubuntu系统
sudo locale-gen de_DE.UTF-8
# CentOS/RHEL系统
sudo localedef -i de_DE -f UTF-8 de_DE.UTF-8

3. 执行脚本前清理SSH环境变量 #

通过SSH执行脚本时，先手动清除环境变量干扰：

LANG= LC_ALL= php your_translation_script.php

4. 完善gettext初始化流程 #

确保翻译域、路径和编码设置完整：

// 设置翻译文件所在目录（需替换为实际路径）
bindtextdomain('my_app', '/var/www/myapp/locale');
// 指定翻译文件的字符编码
bind_textdomain_codeset('my_app', 'UTF-8');
// 启用当前翻译域
textdomain('my_app');

验证方法 #

在脚本中添加调试代码，确认locale设置是否生效：

echo "环境变量LC_ALL: " . getenv('LC_ALL') . PHP_EOL;
echo "setlocale返回值: " . setlocale(LC_ALL, 0) . PHP_EOL;

同时检查.mo文件路径是否符合规范：/path/to/locale/de_DE/LC_MESSAGES/my_app.mo（目录名需与setlocale指定的locale完全匹配）

内容的提问来源于stack exchange，提问作者DevelJoe