首先确认并安装gettext扩展，然后在php.ini中启用extension=gettext，接着创建并编译PO/MO语言文件至locale目录，再通过setlocale、bindtextdomain和textdomain函数配置语言环境，最后使用_()函数输出翻译；若未生效，需检查系统区域支持并运行locale-gen生成对应语言环境。
如果您在开发多语言网站时需要支持动态语言切换，但发现PHP无法正确显示翻译文本，可能是未启用或未正确配置gettext扩展。以下是解决此问题的步骤：
本文运行环境：Dell XPS 13，Ubuntu 22.04
一、确认PHP环境并安装gettext扩展
gettext是PHP中实现国际化的标准扩展之一，需确保其已安装并启用。在Linux系统中，通常通过包管理器安装。
1、打开终端，执行命令检查当前PHP版本：php -v。
立即学习“PHP免费学习笔记（深入）”；
2、运行以下命令安装gettext扩展（以Debian/Ubuntu为例）：sudo apt-get install php-gettext。
3、如果使用特定版本的PHP（如PHP 8.1），请使用完整包名：sudo apt-get install php8.1-gettext。
4、安装完成后，重启Web服务器（如Apache）：sudo systemctl restart apache2。
二、启用gettext扩展
某些系统安装后仍需手动启用扩展，需修改PHP配置文件php.ini。
1、查找当前使用的php.ini文件路径：php --ini，关注“Loaded Configuration File”项。
2、使用编辑器打开php.ini文件，例如：sudo nano /etc/php/8.1/apache2/php.ini。
3、搜索gettext，确保如下行未被注释：extension=gettext。
4、保存文件并重启Apache服务以应用更改。
三、准备语言文件（PO/MO文件）
gettext依赖于编译后的MO文件进行语言查找，需先创建源PO文件并编译。
1、在项目目录下创建语言文件夹，例如：mkdir -p locale/zh_CN/LC_MESSAGES。
2、使用文本编辑器创建messages.po文件，内容包含翻译条目，例如：
msgid "Hello"
msgstr "你好"
3、将PO文件编译为MO文件：msgfmt messages.po -o locale/zh_CN/LC_MESSAGES/messages.mo。
四、在PHP代码中调用gettext函数
通过setlocale和bindtextdomain等函数绑定语言域，使gettext能正确加载翻译资源。
1、在PHP脚本开头设置本地化环境：setlocale(LC_ALL, 'zh_CN.UTF-8');。
2、指定语言文件存储路径：bindtextdomain('messages', './locale');。
3、设置默认文本域：textdomain('messages');。
4、使用gettext函数输出翻译文本：echo _("Hello");，将显示“你好”。
五、处理编码与区域设置问题
若gettext返回原始字符串而非翻译内容，可能是区域未正确生成。
1、检查系统是否支持目标语言区域：locale -a | grep zh_CN。
2、若无输出，生成中文区域：sudo locale-gen zh_CN.UTF-8。
3、更新系统区域配置：sudo update-locale。
4、再次测试setlocale返回值，确保其不为false。
