利用 gettext 來實現 PHP 的國際化編程

通常人們寫程序時都是將文字寫死在程序裏的，比如：echo "Hello World!"; ，假如要改成它國語言，寫國際化程序，就要逐個打開進行修改，程序較短時還行，若程序有上萬甚至更多，改起來就不是那麼容易了。近來隨着i18n的逐漸標準化，我也來講一講在PHP中如何實現國際化支持。跟其他程序語言一樣，在 PHP 也可以利用 gettext 套件寫作 i18n 程序，實現 NLS(Native Language Support) 國際化支持，具體請參考官方文檔( http://www.gnu.org/manual/gettext/index.html )。

　　實現流程：程序設計者在程序碼中寫入所要顯示的信息，在運行程序時並不會直接顯示程序設計師所寫的信息，而會先去找一個所設置語系的信息檔。如果未找到，纔會去顯示程式碼中的信息。

　　一、安裝設置gettext套件：
　　1) *NIX系統:
　　1、從 http://www.gnu.org/software/gettext/gettext.html 下載 gettext package，進行安裝
　　2、編譯PHP的時候加上“--with-gettext[=DIR]”，其中DIR爲gettext安裝的
目錄，缺省爲：/usr/local
　　3、保存，然後 restart server。

　　2) WIN32系統:
　　1、需要將gnu_gettext.dll檔拷貝到系統目錄下面 (Ex: C:/WINNT/SYSTEM32 or C:/WINDOWS/SYSTEM32)，PHP 4.2.3 之後文件名爲 libintl-1.dll，可在 php4/dlls 下獲得。
　　2、打開php.ini檔，查找extension=php_gettext.dll，去掉前面的“;”
　　3、保存，然後restart server。

　　若一切順利，就可以在 phpinfo() 中看到 gettext 字樣，至此已設置完畢。

　　二、php_gettext.dll套件裏有好幾個函式，具體請看相關的manual。在這裏我們只用記住3個函式就行了，如下：

1. string bindtextdomain ( string domain, string directory)
2. string textdomain ( string text_domain)
3. string gettext ( string message)

　　三、寫作i18n程序：

1. <?php
2. // 常規的程序
3. echo "Hello World!");
4. ?>

　　下面是 i18n 程序：hello.php

1. <?php
2. // I18N 程序範例開始
3. define('PACKAGE', 'hello'); // 定義要用的mo文件名稱，常規來說，我們都把PACKAGE的名稱定義和程序名稱相同。
5. putenv('LANG=zh_TW');
6. setlocale(LC_ALL, 'zh_TW'); // 指定要用的語系，如：en_US、zh_CN、zh_TW
8. bindtextdomain(PACKAGE, '/apache/htdocs/locale');
9. textdomain(PACKAGE);
11. // The .mo file searched is:
12. // /apache/htdocs/locale/en/LC_MESSAGES/hello.mo
14. echo gettext("Hello World!");
15. ?>

　　在IE中輸入：http://localhost/hello.php，輸出結果爲：“Hello World!”
　　note：按照 GNU package 裏面的習慣，可以使用 _(...) 來代替 gettext(...) ，這樣就可以少打很多 gettext 了。

　　四、接下來設置gettext po檔：
　　1、創建目錄結構，如下所示：
　　　　bindtextdomain's dir
　　　　　　/language
　　　　　　　　/LC_MESSAGES
　　　　　　　　　　domain.po
　　　　　　　　　　domain.mo
　　其中 bindtextdomain's dir 爲 bindtextdomain() 所用的目錄，language 爲要用
的語系，domain 爲 PACKAGE 名稱。

　　以上面爲例：
　　　　/locale
　　　　　　/zh_TW
　　　　　　　　/LC_MESSAGES
　　　　　　　　　　hello.po
　　　　　　　　　　hello.mo

　　2、創建PO檔
　　xgettext -d [您定義的PACKAGE名稱] [程序文件名]
　　WIN32下面的xgettext、msgfmt程序檔可以從 ( http://switch.dl.sourceforge.net/sourceforge/gnuwin32/gettext-0.10.40-bin.zip ) 下載，需要 libiconv.dll,、libintl.dll 的支持。

　　以上面hello.php檔爲例，
　　$ xgettext -d hello hello.php
　　運行後將產生一個hello.po檔，內容如下：
# SOME DESCRIPTIVE TITLE.
# Copyright © YEAR Free Software Foundation, Inc.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: PACKAGE VERSION/n"
"POT-Creation-Date: 2003-04-21 22:31+0800/n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE/n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>/n"
"Language-Team: LANGUAGE <[email protected]>/n"
"MIME-Version: 1.0/n"
"Content-Type: text/plain; charset=CHARSET/n"
"Content-Transfer-Encoding: 8bit/n"

#: hello.php:14
msgid "Hello World!"
msgstr ""

　　裏面列出 hello.php 檔裏所有調用 gettext 函式的字符串，翻譯的時候只需將
 msgid 值翻譯填入 msgstr 即可，如翻譯成中文。
# SOME DESCRIPTIVE TITLE.
# Copyright © 2003 Ptker All Right Reserved.
# FIRST AUTHOR <[email protected]>, 2003.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: 0.1/n"
"POT-Creation-Date: 2003-04-21 22:31+0800/n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE/n"
"Last-Translator: Ptker <[email protected]>/n"
"Language-Team: zh_TW <[email protected]>/n"
"MIME-Version: 1.0/n"
"Content-Type: text/plain; charset=BIG5/n"
"Content-Transfer-Encoding: 8bit/n"

#: hello.php:14
msgid "Hello World!"
msgstr "世界，您好！"

　　3、創建MO檔
　　msgfmt -o hello.mo hello.po
　　運行後將產生一個hello.mo二進制檔。

　　4、最後將 hello.po、hello.mo 拷貝到相關語系的目錄下即可。

　　五、在IE中輸入： http://localhost/hello.php ，現在的結果就是：“世界，您好！”