学习php gettext的最佳实践 (让你的网站轻松支持多国语言)

发布日期： 2025-10-21 阅读量： 作者： admin

最近手头有个项目，一开始没想那么多，后来客户说要做多语言，得支持英文和中文。这下就得琢磨怎么搞了。之前也零散接触过一些国际化的东西，但没正经用过。寻思着 PHP 里头应该有现成的方案。

翻了翻资料，看到了 gettext 这个东西。看介绍好像挺多人在用，而且是 GNU 那一套，感觉应该比较靠谱。虽然也有其他库，但我看 gettext 好像是 PHP 内建支持（需要装扩展），就想着先试试这个，省得再引入别的依赖。

开始动手折腾

第一步，我得确认下我服务器环境里有没有 gettext 扩展。跑了个 `phpinfo()` 看了下，还已经装上了。要是没有的话，就得自己编译或者用包管理器安装一下，比如 `apt-get install php-gettext` 这样。

我就开始规划目录结构了。按照 gettext 的规矩，一般是在项目里建个 `locale` 目录，然后在里面按语言代码分子目录，比如 `en_US` 代表美式英语，`zh_CN` 代表简体中文。每个语言目录下再建个 `LC_MESSAGES` 目录，这里面放的就是最终编译好的翻译文件（`.mo` 文件）和原始的翻译文件（`.po` 文件）。

结构大概是这样：

/ (项目根目录)
locale/
en_US/
LC_MESSAGES/
* (原始翻译文件)
* (编译后的文件)
zh_CN/
LC_MESSAGES/

这里的 `messages` 是我给翻译文件取的名字，也叫域（domain），可以自己定，但要保持一致。

在代码里埋点

接下来就是在 PHP 代码里配置 gettext 了。我找了个统一的入口文件，或者配置文件，加上了这么几行：

先得告诉 gettext 去哪里找翻译文件。我用了 `bindtextdomain`，指定了刚刚那个 `messages` 域和 `locale` 目录的路径。

然后用 `textdomain` 函数，告诉 gettext 当前要用哪个域，也就是 `messages`。

最关键的是设置当前的语言环境，这个得用 `setlocale` 函数。比如要用中文，就设置成 `LC_ALL`, `zh_*-8`。这个 `zh_*-8` 必须是你服务器系统里支持的 locale 名称，有时候这里会踩坑，得确认系统里真的安装了这个语言包。还得告诉 PHP 编码方式，用 `bind_textdomain_codeset` 设置成 UTF-8，免得乱码。

我把决定用哪个语言的逻辑也写在这里，比如根据用户的浏览器设置、或者 URL 参数、或者 Session 里存的偏好来动态 `setlocale`。

配置好了之后，就是改造代码了。把所有需要翻译的字符串，都用 `_()` 这个函数包起来。比如原来是 `echo "Welcome";`，现在改成 `echo _("Welcome");`。这个 `_()` 就是 `gettext()` 函数的别名，写起来方便点。

生成和翻译文件

代码改得差不多了，接下来就是体力活了。我得把代码里所有 `_()` 包起来的字符串都提取出来，生成一个 `.po` 模板文件（`.pot`）。

这得用命令行工具 `xgettext`。我写了个简单的命令，大概是指定了我的 PHP 文件在哪里，输出一个 `*` 文件。比如：

xgettext --from-code=UTF-8 -o locale/* my_php_files/.php

拿到这个 `.pot` 文件后，我就把它复制到 `en_US/LC_MESSAGES` 和 `zh_CN/LC_MESSAGES` 目录下，并重命名为 `*`。

然后就是编辑 `.po` 文件了。这文件里面就是一行原文 `msgid "Welcome"`，跟着一行空的译文 `msgstr ""`。我就把英文版的 `*` 文件里的 `msgstr` 填上英文（原文就是英文，有时候可能也需要微调），中文版的 `*` 就填上对应的中文翻译。

我开始是直接用文本编辑器打开 `.po` 文件改的，后来发现有点麻烦，特别是字符串多了以后。就去找了个专门编辑 `.po` 文件的工具，叫 Poedit，图形界面的，用起来方便多了，还能检查格式错误。

翻译填好后，一步就是把 `.po` 文件编译成 gettext 能直接读取的二进制 `.mo` 文件。这要用另一个命令行工具 `msgfmt`。

msgfmt locale/zh_CN/LC_MESSAGES/* -o locale/zh_CN/LC_MESSAGES/*

对每个语言的 `.po` 文件都执行一次，生成对应的 `.mo` 文件。

跑起来看看效果

把 `.mo` 文件都生成好放到对应的目录后，我清了清缓存（gettext 有时候会缓存翻译，特别是用 APCu 的时候），然后访问我的网站。通过切换语言参数（比如加个 `?lang=zh_CN`），页面上的文字真的变了！从英文切换到中文，之前用 `_()` 包起来的地方都显示了对应的中文翻译。

过程中也遇到点小问题。有一次是 `setlocale` 没生效，查了半天发现是服务器上没装对应的语言包。还有一次是修改了 `.po` 文件，重新生成了 `.mo`，但页面没变化，后来发现是 gettext 缓存没更新，重启了一下 php-fpm 才

总结一下

用 PHP 的 gettext 来做多语言支持，感觉还是挺靠谱的。优点是：

它是标准，很多系统和工具都支持。
性能不错，因为 `.mo` 是编译后的二进制文件，读取快。
能和很多翻译工具（比如 Poedit）配合，方便管理翻译。

不过也有点麻烦的地方：

每次修改了翻译，都需要手动去运行 `msgfmt` 编译 `.mo` 文件，有点繁琐，最好是集成到部署流程里自动化。
`setlocale` 依赖服务器系统环境，有时候部署到不同环境需要确认 locale 设置。
对于动态内容里的翻译（比如数据库里存的），gettext 就无能为力了，得自己想别的办法。

但对于固定界面文本的翻译，gettext 确实是个不错的选择。这回折腾下来，也算是把这套流程跑通了，以后再做多语言项目心里就有底了。

上一篇: 中国香港的服务器贵吗？看完价格你就清楚了！

学习php gettext的最佳实践 (让你的网站轻松支持多国语言)

随便看看