php的gettext用法,PHP环境gettext使用指引

gettext简介

gettext是一种国际化与本地化系统，在类Unix系统中编写多语言程序时经常被使用。gettext的一个常用的实现版本为GNU gettext，1995年发布。

源代码中所有需要多语言支持的(需要翻译的)字符串都修改为使用 gettext

函数包装起来。为了方便也可以使用下划线 _

。比如：

echo gettext('示例');

echo _('示例');

gettext需要先配置好对应的语言包，并在代码中进行设置需要翻译的语言，然后根据对应的语言包对选择的文本进行翻译。

其中gettext会用到两个语言文件，一个以 .po

结尾，是我们用于编辑语言翻译的文本文件，另外一个以 .mo

结尾，这个是 .po

文件的二进制版本，也是 PHP 程序真正使用的文件。

我们每次修改了 .po

文件之后都需要编译成对应的 .mo

文件。这些文件的编辑可以用软件 Poedit

来操作。

PHP环境gettext使用指引

1、确定 PHP 已安装且已启用gettext拓展(现在机器基本都已安装且启用)，通过以下命令查看是否已开启。

php -m | grep gettext

2、window、 linux 环境需安装gettext(仅用于开发环境生成PO文件，线上环境不需安装)

window直接在 这里

下载，并且需要把 bin

目录设置到环境变量的 path

里去

linux 通过命令直接安装 yum install gettext

3、对代码里所有需要翻译的文本，用 _

或者 gettext

封装起来，如下

throw new CustomException(_('请输入备注'), StatusCode::PARAMETER);

4、生成PO和MO文件

通过命令行生成

# 把所有需要生成的php文件罗列出来

find app -type f -name '*.php' -print | sort >file_list

# 通过xgettext生成po文件

# -d表示表示生成为***.po

# -D表示需要查找的目录 疑似不生效 因此使用find配合

# -j表示为在源输出文件后增加，不会覆盖原有翻译后的内容，首次生成不需要添加-j参数

# --files-from表示从文件读入需要扫描的源文件

# --no-wrap 翻译的文案过长，生成的po文件会自动换行，增加--no-wrap解决换行问题

# --strict 增加--strict做成严格统一的注释说明

xgettext --files-from=file_list -d setup_service --from-code=utf-8 -L PHP --no-wrap --strict

#生成对应的mo文件

msgfmt setup_service.po -o setup_service.mo

也可以通过Poedit来生成 po

文件

打开软件，然后按 ctrl+n

新建文件，选择要翻译成的语言，例如英语，点击确定

这样就新建了一个文件，按 ctrl+s

保存文件(保存后才能操作)，输入要保存的名字和位置

按 alt+enter

打开属性设置页面，点击 源路径

,再点击在 路径

下面的 +

，选择要生成 po

文件的文件夹或者文件，点击确定

点击上方菜单栏的 从代码更新

。

此时软件即会提取需要翻译的文本，生成对应的po文件。

ctrl+s

保存文件，同时会生成对应的 .mo

文件。

也可以通过Poedit来编辑 po

文件

安装了Poedit后，双击po文件即可打开进行编辑。

将PO文件的头部 charset

的部分修改为 charset=UTF-8

或增加以下代码(建议)

"Plural-Forms: nplurals=1; plural=0;\n"

"Project-Id-Version: \n"

"POT-Creation-Date: \n"

"PO-Revision-Date: \n"

"Last-Translator: \n"

"Language-Team: \n"

"MIME-Version: 1.0\n"

"Content-Type: text/plain; charset=UTF-8\n"

"Content-Transfer-Encoding: 8bit\n"

"Language: en_US\n"

"X-Generator: Poedit 2.2\n"

"X-Poedit-SourceCharset: UTF-8\n"

5、代码里使用gettext

if (self::isCn()) {

putenv('LANG=zh_CN');

#setlocale(LC_ALL, 'zh_CN'); //centos可以直接用这行，ubuntu需要用下面一行带utf8的。下同

setlocale(LC_ALL, 'zh_CN.utf8');

} elseif (self::isHk()) {

putenv('LANG=zh_HK');

setlocale(LC_ALL, 'zh_HK.utf8');

} elseif (self::isEn()) {

putenv('LANG=en_US');

setlocale(LC_ALL, 'en_US.utf8'); //指定要用的语系，如：en_US、zh_CN、zh_HK

}

bindtextdomain('setup_service', resource_path('locale')); //设置某个域的mo文件路径

bind_textdomain_codeset('setup_service', 'UTF-8'); //设置mo文件的编码为UTF-8

textdomain('setup_service');

#对应路径为

locale/en_US/LC_MESSAGES/setup_service.po

locale/en_US/LC_MESSAGES/setup_service.mo

6、访问系统，可实现多语言返回结果。