php gettext方式实现UTF-8国际化多语言(i18n)

一、总结

一句话总结：

二、php gettext方式实现UTF-8国际化多语言(i18n)

近来随着i18n(国际化)的逐渐标准化，我也来讲一讲在PHP中如何实现国际化支持。跟其他程序语言一样，在 PHP 也可以利用 gettext 套件写作 i18n 程序，实现 NLS(Native Language Support) 国际化支持，具体请参考官方文档( http://www.gnu.org/software/gettext/manual/gettext.html)

这里我们主要介绍window平台下使用php的扩展gettext实现程序的国际化。

gettext简介：
GNU gettext是翻译项目的重要一步，它提供了一个工作框架，由一些集成的工具和文档组成，帮助程序员、翻译人员和最终用户实现程序的国际化和本地化。用 Gettext的方式实现多语言得到了广泛的支持，著名的BLOG程序wordpress的国际化就是用的GNU gettext。

大致原理：
GNU gettext使用PO或MO文件来实现国际化和本地化。PO的意思是Portable Object，是一种文本结构，可以方便的由人们阅读和修改。MO是Machine Object的简写，MO文件是PO文件的二进制形态。一般来说，一个PO或MO文件对应于一种语言，如果一个程序要支持多种语言，每一种语言都需要自己的PO或MO文件。

开始应用：

步骤一：搭建环境(服务器已经完成，环境已经搭建好了)
1、首先查看你的php扩展目录下是否有php_gettext.dll这个文件，如果没有，这就需要你下载一个或是从其他地方拷贝一个，然后放到php扩展目录。
2、打开php.ini，查找”;extension=php_gettext.dll“ ，然后去除注释，重启apache。

若一切顺利，就可以在 phpinfo() 中看到 gettext 字样，至此服务器环境配置完毕。

步骤二：假如我们要翻译test.php页面里的hello word!这句话。

编辑test.php，将要翻译的文字用gettext函数包含，表示这些被包含的文字是需要用来翻译的。

<?
include_once ( 'inc/setLan.php' );
$domain='test' ;
//域名，可以任意取个有意义的名字，不过要跟相应的.mo文件的文件名相同（不包括扩展名）。
bindtextdomain ( $domain,"locale/" ); //设置某个域的mo文件路径
bind_textdomain_codeset($domain,'UTF-8' ); //设置mo文件的编码为UTF-8
textdomain($domain ); //设置gettext()函数从哪个域去找mo文件
?>
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8"/>
<title>title</title>
</head>
<body bgcolor="#FFFFFF" text="#000000" link="#FF9966" vlink="#FF9966" alink="#FFCC99">
<?= gettext ( 'hello world.' ) ?>
</body>
</html>

这里的setLan.php组件是用来接收语言参数的，当调用test.php?lan=zh_CN的时候，则显示中文翻译后的页面，调用 test.php?lan=zh_TW，则显示繁体翻译后的页面，当没有参数的情况，则默认根据http头信息里的语言进行显示，如果头信息里的语言我们没有提供语言包，则默认显示gettext函数里包含的文字。
setLan.php代码：

<?php
$lan=$_REQUEST [ 'lan' ];
if ( $lan=='zh_CN' ){
putenv('LANG=zh_CN' );
setlocale(LC_ALL,'zh_CN' ); //指定要用的语系，如：en_US、zh_CN、zh_TW
}elseif ( $lan=='zh_TW' ){
putenv('LANG=zh_TW' );
setlocale(LC_ALL,'zh_TW' ); //指定要用的语系，如：en_US、zh_CN、zh_TW
}elseif ( $lan=='en_US' ) {
putenv('LANG=en_US' );
setlocale(LC_ALL,'en_US' ); //指定要用的语系，如：en_US、zh_CN、zh_TW
}
?>

步骤三：编辑好了test.php后，我们就应该对这个页面生成对应的语言包(test.po和test.mo文件)

要生成语言包，我们需要借助两款工具：

1、gettext工具下载地址：http://nchc.dl.sourceforge.net/sourceforge/gnuwin32/gettext-0.14.4.exe

（用来生成po文件，安装好了以后，需要把”安装路径/bin”添加到系统环境变量path里）
2、Poedit工具下载地址：http://www.poedit.net/download.php (用来编辑po文件，编辑需要翻译的语言，最后自动生成mo文件)

假设我们都安装好了这些软件，现在我们开始对test.php进行翻译工作。打开命令提示符cmd，切换到test.php所在的目录。

输入 xgettext -d test test.php --from-code=utf-8 (当你要翻译的页面为index.php，只需要将蓝色部分改为index即可),然后执行，这时候你可以在test.php所在目录看到新生成的文件test.po

用poedit工具打开test.po，然后针对这些语言翻译成我们对应的语言，保存后poedit会自动生产mo文件(unicode二进制码)。

将po文件和mo文件放入项目目录

/locale/language/LC_MESSAGES/test.po

/locale/language/LC_MESSAGES/test.mo

如我们放入的是简体中文，则放入：

/locale/zh_CN/LC_MESSAGES/test.po

/locale/zh_CN/LC_MESSAGES/test.mo

如我们放入的是繁体中文，则放入：

/locale/zh_TW/LC_MESSAGES/test.po

/locale/zh_TW/LC_MESSAGES/test.mo

OK。一切都非常顺利，我们开始访问测试下多语言吧。访问test.php?lan=zh_CN则显示简体，访问test.php?lan=zh_TW显示繁体。有什么问题，留言共同讨论：）

php 通过include方式实现国际化多语言(i18n) :

最后记得要 重启Apache，方可看到效果。

++++++++++++++++++++++++++++++++++++++++++

如何将多个文件的语言翻译放到同一个.mo文件中？？？

如下图，测试项目文件结构如下：

现想把前台文件 test.php，test2.php 等文件的语言包等放集中放在cn.mo文件中，操作如下：

只需要把 test.php，test2.php 等文件的语言包“域”都设置为“cn”，并且在对每个php文件生成.mo文件时，以追加的形式添加到“域cn” 即可。

test.php 文件内容如下：

<?
putenv ('LANG=zh_CN' );
setlocale ( LC_ALL,'zh_CN' );
//定义要用的语言文件名称
$domain='cn' ;
bindtextdomain ( $domain,dirname(__FILE__).'/locale' ); //设置某个域的mo文件路径
bind_textdomain_codeset($domain,'UTF-8' ); //设置mo文件的编码为UTF-8
textdomain($domain ); //设置gettext()函数从哪个域去找mo文件
?>
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8"/>
<title>title</title>
</head>
<body bgcolor="#FFFFFF" text="#000000" link="#FF9966" vlink="#FF9966" alink="#FFCC99">
<?=gettext ('hello world.') ?>
</body>
</html>

生成.po文件命令如下：

xgettext -d cn test.php --from-code=utf-8

test2.php 文件内容如下：

生成.po文件命令如下：（注意，此时多加了一个命令参数 -j ，表明是以追加的形式添加语言包的。）

xgettext -d cn test.php

最终生成的 .po 文件效果如下：

最后把生成的 “cn.po”、“cn.mo” 文件拷贝到文件夹 “locale\zh_CN\LC_MESSAGES\” 中。

最最后就是重启下Apache啦。

附：wordpress之模板汉化(poedit的使用技巧
及 .po .mo 批量生成技术)