xgettext php,gettext简介 | 学步园

由fanyamin翻译摘录自php.net及

http://www.onlamp.com/pub/a/php/2002/06/13/php.html

gettext函数实现了本地化语言支持的应用程序接口，可用于PHP应用程序的国际化，详细的说明文档请参见

http://www.gnu.org/software/gettext/manual/index.html

要在你的PHP安装中加入GNU gettext支持，必需增加--with-gettext[=DIR]选择，其中 DIR 是 gettext 的安装目录,默认为/usr/local.

注意对于win32用户，必需拷贝gnu_gettext.dll到windows下的SYSTEM32目录，从PHP 4.2.3开始更名为libintl-1.dll，而且同时要安装iconv.dll

函数列表

bind_textdomain_codeset --  Specify the character encoding in which the messages from the DOMAIN message catalog will be returned

bindtextdomain -- Sets the path for a domain

dcgettext -- Overrides the domain for a single lookup

dcngettext -- Plural version of dcgettext

dgettext -- Override the current domain

dngettext -- Plural version of dgettext

gettext -- Lookup a message in the current domain

ngettext -- Plural version of gettext

textdomain -- Sets the default domain

为简单起见，Gettext PHP extension允许通过使用gettext()函数在你的PHP代码中动态地翻译源字串为适宜的目的字串，

如果那个字串仍没有被翻译，则保留源字串。

例如

// I18N support information here

$language = 'en';

putenv("LANG=$language");

setlocale(LC_ALL, $language);

// Set the text domain as 'messages'

$domain = 'messages';

bindtextdomain($domain, "/www/htdocs/site.com/locale");

textdomain($domain);

echo gettext("A string to be translated would go here");

?>

安装Gettext文件

Gettext需要一个拥有全部翻译字串的locale目录，基本结构如下

/locale

/en

/LC_MESSAGES

messages.po

messages.mo

在locale目录中要为每一个你想要支持的语言创建一个子目录

// The language code goes here

$language = 'zh_CN';

putenv("LANG=$language");

setlocale(LC_ALL, $language);

// ....

?>

例如：

/locale

/en

/LC_MESSAGES

messages.po

messages.mo

/zh_CN

/LC_MESSAGES

messages.po

messages.mo

zh_CN目录创建以后，在PHP文件中用gettext函数标注需要翻译和文本，然后可以用命令

$xgettext -n *.php

来生成翻译字串文件messages.po，举例如下

# SOME DESCRIPTIVE TITLE.

# Copyright (C) YEAR Free Software Foundation, Inc.

# FIRST AUTHOR , YEAR.

#

#, fuzzy

msgid ""

msgstr ""

"Project-Id-Version: PACKAGE VERSION/n"

"POT-Creation-Date: 2002-04-06 21:44-0500/n"

"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE/n"

"Last-Translator: FULL NAME /n"

"Language-Team: LANGUAGE /n"

"MIME-Version: 1.0/n"

"Content-Type: text/plain; charset=CHARSET/n"

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

#: gettext_example.php:12

msgid "A string to be translated would go here"

msgstr ""

这个文件包括所有在gettext()调用的字串，可提供给翻译者翻译成不同的语言

然后，就可把这些pot文件*.po转换成Gettext函数真正能够了解的二进制文件*.mo

以下命令可以创建一个message.mo文件，且须放置在正确的目录下locale//LC_MESSAGES/

$ msgfmt messages.po

注意如果新增一包含新字串的新文件，如何维护一个包括所有字串翻译的不断更新的message.po文件

这时就可利用gettext的msgmerge 功能

$ ls

example.php

$ xgettext -n *.php

$ ls

example.php   messages.po

// ...

// Translates the messages.po file now

// ...

$ msgfmt messages.po

$ ls

example.php   messages.po   messages.mo

// ...

// Changes the example.php file

// ...

$ mv messages.po old.po

$ xgettext -n *.php

$ ls

example.php   messages.po   messages.mo   old.po

$ msgmerge old.po messages.po --output-file=new.po

$ ls

example.php   messages.po   messages.mo   new.po    old.po

// ...

// Translates the new.po file

// ...

$ msgfmt new.po