gettext库 多语言国际化2

通常人们写程序时都是将文字写死在程序里的，比如：echo "Hello World!"; ，假如要改成它国语言，写国际化程序，就要逐个打开进行修改，程序较短时还行，若程序有上万甚至更多，改起来就不是那么容易了。近来随着i18n的逐渐标准化，我也来讲一讲在PHP中如何实现国际化支持。跟其他程序语言一样，在 PHP 也可以利用 gettext 套件写作 i18n 程序，实现 NLS(Native Language Support) 国际化支持。

 

实现流程：程序设计者在程序码中写入所要显示的信息，在运行程序时并不会直接显示程序设计师所写的信息，而会先去找一个所设置语系的信息档。如果未找到，才会去显示程式码中的信息。

一、安装设置gettext 套件：
windows系统:
1、打开php.ini档，查找extension=php_gettext.dll，去掉前面的“;”
2、保存，然后restart server。

若一切顺利，就可以在 phpinfo() 中看到 gettext 字样，至此已设置完毕。

二、php_gettext.dll套件里有好几个函式，具体请看相关的manual。在这里我们只用记住3个函式就行了，如下：

string bindtextdomain ( string domain, string directory)
string textdomain ( string text_domain)
string gettext ( string message)

 

2,php-gettext的使用.以一个具体的例子说明

如果debian系列的linux用户，注意查看本地语言支持。 vim /usr/share/i18n/SUPPORTED

中文:zh_CN.UTF-8

英文:en_US.UTF-8

德文:de_DE.UTF-8

法文:fr_FR.UTF-8

如果没有，则相应的安装之。方法:sudo apt-get locale-gen zh_CN.UTF-8 

在php程序中,可以使用gettext()来标记需要翻译的语言包,gettext()函数常用_()代替;

2.1 建立文件目录

mkdir gettext

cd gettext

touch Locale.php

touch test.php

//中文mo文件的地方.

mkdir -p Locale/zh_CN/LC_MESSAGES 

//英文文mo文件的地方.

mkdir -p Locale/en_US/LC_MESSAGES

 

至于编辑工具，由于 po 文件本身就是一个文本文件，所以任何文本编辑器都可以使用。除了专门编辑 po 文件的 poEdit ，还推荐使用 poEdit 、EditPlus 、UltraEdit 或者你喜欢的 vi 或 vim 。
汉化mo文件需要的工具叫gettext，去http://gnuwin32.sourceforge.net/packages/gettext.htm 下载一个回来安装，然后运行:
msgunfmt.exe d:\english.mo -o d:\english.po
对english.po进行编辑、翻译，完成后再运行:
msgfmt.exe -o d:\chinese.mo d:\english.po
然后就编译完成了chinese.mo文件。 

 

AccountSections.php

_('Could not retrieve the requested section please try again.');

mo文件中对应：

#: AccountSections.php:187
msgid "Could not retrieve the requested section please try again." //对应页面调用的key
msgstr "不能取回要求的类别, 请重试"  //显示文字

 

2.2 Locale.php文件代码

<?php 
/**
 * Dh_Locale 语言包类
 *
 * 系统语言包采用的是php-gettext模块.
 * 如果模板使用的是smarty.使用了smarty-gettext插件.插件地址http://sourceforge.net/projects/smarty-gettext/
 *  php-gettext的安装和使用(ubuntu平台下)
 *  1 Installation of gettext package: sudo apt-get install php-gettext
 *  2 Install locales: see all locales in the file vim /usr/share/i18n/SUPPORTED
 *  3 设置文件目录结构;如: Locale/zh_CN/LC_MESSAGES 或者 Locale/en_US/LC_MESSAGES
 *  4 如果是smarty模板(使用{t}你好{/t}标记)。生成.c格式的文件;如:php -q tsmarty2c.php  $file > text.c
 *  5 生成.po格式的文件;xgettext -o Dh.po --join-existing --omit-header --no-location text.c 
 *  6 生成.mo格式的文件;msgfmt Dh.po -o Dh.mo
 *  7 移动mo文件到相应的Locale/en_US/LC_MESSAGES文件夹下面
 *
 * @package 
 * @version $id$
 * @copyright 1997-2005 The PHP Group
 * @author erhuok <[e-mail]> 
 * @license PHP Version 3.0 {@link http://www.php.net/license/3_0.txt}
 */
class Dh_Locale {
    /**
     * _options 设置语言包的选项 
     *
     * $this->_options['lang'] 应用程序使用什么语言包.php-gettext支持的所有语言都可以.
     * 在ubuntu下使用sudo vim /usr/share/i18n/SUPPORTED 主要是utf8编码
     * $this->_options['domain'] 生成的.mo文件的名字.一般是应用程序名
     *
     * @var array
     * @access protected
     */
    protected $_options; 
    /**
     * __construct 构造函数 对象初始化时设置语言包的参数 
     * 
     * @access public
     * @return void
     */
    public function __construct($lang=null) {
        switch ( $lang ) {
            case 'cn':
                $this->_options = array('lang' => 'zh_CN.utf8','domain'=>'Dh');
                break;
            case 'en':
            case 'us':
            case 'eu':
                $this->_options = array('lang' => 'en_US.utf8','domain'=>'Dh');
                break;
            case 'de':
                $this->_options = array('lang' => 'de_DE.utf8','domain'=>'Dh');
                break;
            case 'fr':
                $this->_options = array('lang' => 'fr_FR.utf8','domain'=>'Dh');
            default:
                $this->_options = array('lang' => 'zh_CN.utf8','domain'=>'Dh');
                break;
        }
        $this->setApplicationLocale();
    }
    /**
     * setOptions 设置应用程序语言包的参数 放在在数组$this->_options中 
     * 
     * @param mixed $options 
     * @access public
     * @return void
     */
    public function setOptions($options) {
        if(!empty($options)) {
            foreach ($options as $key => $option) {
                $this->_options[$key] = $option;
            }
        }
    }
    /**
     * setApplicationLocale  设置应用程序语言包 
     * 
     * @access public
     * @return void
     */
    public function setApplicationLocale() {
        putenv('LANG='.$this->_options['lang']);
        setlocale(LC_ALL,$this->_options['lang']);
        bindtextdomain($this->_options['domain'],dirname(__FILE__).'/Locale/');
        textdomain($this->_options['domain']);
        bind_textdomain_codeset($this->_options['domain'],'UTF-8');
    }
}
?>

2.3 测试用例

<?php
require_once dirname(__FILE__).'/Locale.php';
//cn or en
$Lang = 'cn';
$Locale = new Dh_Locale($Lang);
$Checkout['AddressFields'] = array
(
    'Email' => array
    (
        'Type' => 'text',
        'Label' => _('邮箱'),
        'Title' => _('请填写邮箱'),
        'Class' => 'required',
        'Filter' => 'string',
    ),
    'PostCode' => array
    (
        'Type' => 'text',
        'Label' => _('邮政编码'),
        'Title' => _('请填写邮政编码'),
        'Class' => 'required',
        'Filter' => 'int',
    ),
);
echo '<pre>';print_r($Checkout);echo '</pre>';
?>

评论

1 楼 dewei 2011-03-26  

还有进一步说明吗？
好像没说完啊。