«
利用 gettext 来实现 PHP 的国际化编程

时间:2008-5-31    作者:Deri    分类: 分享


   <p>  通常人们写程序时都是将文字写死在程序里的,比如:echo "Hello World!"; ,假如要改成它国语言,写国际化程序,就要逐个打开进行修改,程序较短时还行,若程序有上万甚至更多,改起来就不是那么容易了。近来随着i18n的逐渐标准化,我也来讲一讲在PHP中如何实现国际化支持。跟其他程序语言一样,在 PHP 也可以利用 gettext 套件写作 i18n 程序,实现 NLS(Native Language Support) 国际化支持,具体请参考官方文档( <a href="http://www.gnu.org/manual/gettext/index.html" target="_blank">http://www.gnu.org/manual/gettext/index.html</a>&#160;)。</p><p>  实现流程:程序设计者在程序码中写入所要显示的信息,在运行程序时并不会直接显示程序设计师所写的信息,而会先去找一个所设置语系的信息档。如果未找到,才会去显示程式码中的信息。</p><p>  一、安装设置gettext套件:</p><p>  1) *NIX系统:</p><p>  1、从 <a href="http://www.gnu.org/software/gettext/gettext.html" target="_blank">http://www.gnu.org/software/gettext/gettext.html</a> 下载 gettext package,进行安装</p><p>  2、编译PHP的时候加上“--with-gettext[=DIR]”,其中DIR为gettext安装的</p><p>  目录,缺省为:/usr/local</p><p>  3、保存,然后 restart server。</p><p>  2) WIN32系统:</p><p>  1、需要将gnu_gettext.dll档拷贝到系统目录下面 (Ex: C:\WINNT\SYSTEM32 or C:\WINDOWS\SYSTEM32),PHP 4.2.3 之后文件名为 libintl-1.dll,可在 php4\dlls 下获得。</p><p>  2、打开php.ini档,查找extension=php_gettext.dll,去掉前面的“;”</p><p>  3、保存,然后restart server。</p><p>  若一切顺利,就可以在 phpinfo() 中看到 gettext 字样,至此已设置完毕。</p>
<p> </p>

   <p>  二、php_gettext.dll套件里有好几个函式,具体请看相关的manual。在这里我们只用记住3个函式就行了,如下:</p><ol><li>string bindtextdomain ( string domain, string directory) </li><li>string textdomain ( string text_domain) </li><li>string gettext ( string message)</li></ol><p>  三、写作i18n程序:</p><ol><li><?php </li><li>// 常规的程序 </li><li>echo "Hello World!"); </li><li>?></li></ol><p>  下面是 i18n 程序:hello.php</p><p>  <code><?php<br />// I18N 程序范例开始<br />define('PACKAGE', 'hello'); // 定义要用的mo文件名称,常规来说,我们都把PACKAGE的名称定义和程序名称相同。<br />putenv('LANG=zh_TW');<br />setlocale(LC_ALL, 'zh_TW'); // 指定要用的语系,如:en_US、zh_CN、zh_TW<br />bindtextdomain(PACKAGE, '/apache/htdocs/locale');<br />textdomain(PACKAGE);<br />// The .mo file searched is:<br />// /apache/htdocs/locale/en/LC_MESSAGES/hello.mo<br />echo gettext("Hello World!");<br />?></code></p><p>  在IE中输入:<a href="http://localhost/hello.php" target="_blank">http://localhost/hello.php</a>,输出结果为:“Hello World!”</p><p>  note:按照 GNU package 里面的习惯,可以使用 _(...) 来代替 gettext(...) ,这样就可以少打很多 gettext 了。</p><p>  四、接下来设置gettext po档:</p><p>  1、创建目录结构,如下所示:</p><p>  <code>    bindtextdomain's dir<br />      
    /language<br />        
    /LC_MESSAGES<br />          
    domain.po<br />          
    domain.mo</code></p>
 <p> </p>

   <p>  其中 bindtextdomain's dir 为 bindtextdomain() 所用的目录,language 为要用</p><p>  的语系,domain 为 PACKAGE 名称。</p><p>  以上面为例:</p><p>  <code>    /locale<br />      
    /zh_TW<br />        
    /LC_MESSAGES<br />          
    hello.po<br />          
    hello.mo</code></p><p>  2、创建PO档</p><p>  xgettext -d [您定义的PACKAGE名称] [程序文件名]</p><p>  WIN32下面的xgettext、msgfmt程序档可以从 ( <a href="http://switch.dl.sourceforge.net/sourceforge/gnuwin32/gettext-0.10.40-bin.zip" target="_blank">http://switch.dl.sourceforge.net/sourceforge/gnuwin32/gettext-0.10.40-bin.zip</a>&#160;) 下载,需要 libiconv.dll,、libintl.dll 的支持。</p><p>  以上面hello.php档为例,</p><p>  $ xgettext -d hello hello.php</p><p>  运行后将产生一个hello.po档,内容如下:</p><p>  <code># SOME DESCRIPTIVE TITLE.<br /># Copyright &#169; YEAR Free Software Foundation, Inc.<br /># FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.<br />#<br />#, fuzzy<br />msgid ""<br />msgstr ""<br />"Project-Id-Version: PACKAGE VERSION\n"<br />"POT-Creation-Date: 2003-04-21 22:31+0800\n"<br />"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"<br />"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"<br />"Language-Team: LANGUAGE <LL@li.org>\n"<br />"MIME-Version: 1.0\n"<br />"Content-Type: text/plain; charset=CHARSET\n"<br />"Content-Transfer-Encoding: 8bit\n"<br />#: hello.php:14<br />msgid "Hello World!"<br />msgstr ""</code></p></p><p>  里面列出 hello.php 档里所有调用 gettext 函式的字符串,翻译的时候只需将</p><p>  msgid 值翻译填入 msgstr 即可,如翻译成中文。</p><p>  <code># SOME DESCRIPTIVE TITLE.<br /># Copyright &#169; 2003 Ptker All Right Reserved.<br /># FIRST AUTHOR <ptker@hotmail.com>, 2003.<br />#<br />#, fuzzy<br />msgid ""<br />msgstr ""<br />"Project-Id-Version: 0.1\n"<br />"POT-Creation-Date: 2003-04-21 22:31+0800\n"<br />"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"<br />"Last-Translator: Ptker <ptker@hotmail.com>\n"<br />"Language-Team: zh_TW <ptker@hotmail.com>\n"<br />"MIME-Version: 1.0\n"<br />"Content-Type: text/plain; charset=BIG5\n"<br />"Content-Transfer-Encoding: 8bit\n"<br />#: hello.php:14<br />msgid "Hello World!"<br />msgstr "世界,您好!"</code></p><p>  3、创建MO档</p><p>  <code>msgfmt -o hello.mo hello.po</code></p><p>  运行后将产生一个hello.mo二进制档。</p><p>  4、最后将 hello.po、hello.mo 拷贝到相关语系的目录下即可。</p><p>  五、在IE中输入: <a href="http://localhost/hello.php" target="_blank">http://localhost/hello.php</a> ,现在的结果就是:“世界,您好!”</p></p>