PHP Smarty通过gettext制作多语言版本

一、采用gettext,由于Smarty有相应得gettext的插件，所以就直接用这个插件了

注意：smarty-gettext-0.9.1.zip的README有错误，应为：

$smarty = new Smarty [...];
require('smarty-gettext.php');
$smarty->register_block('t', 'smarty_translate'); // 注意是下划线不是中划线（就因为这点把我害苦啦，老提示找不到相关函数，切记！！！）

步骤如下：

1.1 在公共的包含文件中加入如下的代码：

//$domain_info['lang']为cookie传进来的语言设定值
$language_code = $domain_info['lang'];
//界面语言设置成中文
if($language_code == 'zh_CN')
{
//设置目标语言
putenv("LANG=$language_code");
setlocale(LC_ALL, $language_code);
//$package为mo文件的名字
$package = 'i18n_zh';
//绑定mo文件的路径
bindtextdomain($package, '/var/locale');
//设置搜索的mo文件的文件名
textdomain($package);
//指定mo文件的返回到gettext的编码
bind_textdomain_codeset($package, 'UTF-8');
}
elseif($language_code == 'BIG5')
{
//界面语言设置成繁体
$language_code = 'zh_TW';
putenv("LANG=$language_code");
setlocale(LC_ALL, $language_code);
$package = 'i18n_tw';
bindtextdomain($package, '/var/locale');
textdomain($package);
bind_textdomain_codeset($package, 'UTF-8');
}
else
{
//界面语言是英文
//设置目标语言
putenv("LANG=$language_code");
setlocale(LC_ALL, $language_code);
//$package为mo文件的名字
$package = 'i18n_en';
//绑定mo文件的路径
bindtextdomain($package, '/var/locale');
//设置搜索的mo文件的文件名
textdomain($package);
//指定mo文件的返回到gettext的编码
bind_textdomain_codeset($package, 'UTF-8');
}
//*********添加国际化语言的处理结束***************/

注意：以上代码中标红处的$language_code必须是系统中存在的语言代码，不能自定义，大小写也要一致

1.2 相应的模版中加入smarty插件要求的t标签

1.3 用smarty插件提供的工具 生成c文件

这个c文件是把所有的模版中加了标签的串提取出来了

php -q ./tsmarty2c.php *.html > $package.c

注意：默认的c文件的名和1.1中定义的最好一样

需要注意的是tsmarty2c.php中定义的 smarty的open tag 和close tag 必须与smarty配置文件设置的一致

1.4 调用linux系统得xgettext把1.3中的c文件生成后缀为po的文件

xgettext -d $package $package.c --from-code=utf-8

注意：如果文件不是Asc编码的 还得在上面地命令中指明

--from-code=文件编码

1.5 编辑1.4中生成的$package.po ，加入相应的翻译对应串

有几种语言，就的分别编辑生成几个po文件

1.6 调用linux系统得msgfmt把1.3中的1.5中的po文件生成后缀为mo的 二进制文件

msgfmt -o $package.mo $package.po

1.7 建立locale目录，要与1.1 中的bindtextdomain($package, '/var/locale');设置一样

以1.1中的为例，首先在/var/（ 已有的）目录下建立locale目录，locale的结构为

|-- en_US
| `-- LC_MESSAGES
|
| -- $package.mo

|
|-- zh_CN
| `-- LC_MESSAGES
|
| -- $package.mo

|

`-- zh_TW
` -- LC_MESSAGES
| -- $package.mo

其中的第一层目录是按1.1 中的$language_code的定义设的，必须这样，否则找不到，第二层目录LC_MESSAGES是固定的，里面存放1.6 中生成的mo文件

说明：有时候可能修改了po重新生成了mo文件后，语言包不起作用，这时候重启一下apache就可以了

二、由于是网站用的是Smaty，我们可以把模板中的文字都提取出来，集中放到语言文件中
通过smarty的config_load来加载，前提把语言文件放到$smarty->config_dir所设定的目录中
只要在php中包含 ，如下的代码，

$smarty->config_load( 'chs.lang' );

//$lang为通过cookie或session获得的页面语言值

switch ($lang) {

case 'zh-cn' :

$smarty->config_load( 'chs.lang' );
break;

case 'zh-tw' :

header( 'cht.lang' );
break;

default:

header( 'cht.lang' );
break;

}

php gettext 实现多语言

1.安装gettext

windows用户直接修改php.ini,开启php_gettext.dll扩展

ubuntu用户使用命令：sudo apt-get install php-gettext

centos用户如果编译安装php的时候没有使用–with-gettext参数，则有需要使用phpize编译安装gettext
进入php源码包，如 cd /usr/local/src/php/ext/gettext
执行phpize //运行后此目录下多出了一此configure文件
执行make && make install
按提示将生成的getext.so文件写入到php.ini中。如 extension=gettext.so;
重启apache,/etc/init.d/apache restart

2.配置语言环境

如果是debian系列的linux用户，注意查看本地语言支持，具体查看 /usr/share/i18n/SUPPORTED
例如：中文zh_CN.UTF-8
中文繁体zh_TW.UTF-8
英文en_US.UTF-8
如果没有相应语言，则安装它：suso apt-get locale-gen zh_CN.UTF-8

3.在php项目中使用gettext

在项目中创建语言包目录，例如：
简体中文：Locale/zh_CN/LC_MESSAGES
英文：Locale/en_US/LC_MESSAGES

语言包类：Locale.php

view plaincopy to clipboardprint?
<?php
/**
* Locale 语言包类
* 系统语言包采用的是php-getext模块
* # 如果模板使用的是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
* 2.1 如果没有相应语言则相应安装之。方法：sudo apt-get locale-gen zh_CN.UTF-8
* 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文件夹下面
* @author administrator
*
*/
class Locale
{
/**
* _options 设置语言包的选项
* $this->_options['lang'] 应用程序使用什么语言包.php-gettext支持的所有语言都可以.
* 在ubuntu下使用sudo vim /usr/share/il8n/SUPPORTED 主要是utf8编码
* $this->_options['domain'] 生成的.mo文件的名字.一般是应用程序名
* @var array
* @access protected
*/
protected $_options;

/**
* 构造函数
* 对象初始化是设置语言包的参数
* @param string $lang
* @access public
* @return void
*/
public function __construct($lang=null) {
switch ( strtolower($lang) ) {
case 'zh_tw':
$this->_options = array('lang' => 'zh_TW.UTF8', 'domain' => 'test');
break;
case 'zh_cn':
$this->_options = array('lang' => 'zh_TW.UTF8', 'domain' => 'test');
break;
case 'en':
$this->_options = array('lang' => 'en_US.UTF8', 'domain' => 'test');
break;
case 'en_us':
$this->_options = array('lang' => 'en_US.UTF8', 'domain' => 'test');
break;
case 'en_gb':
$this->_options = array('lang' => 'en_US.UTF8', 'domain' => 'test');
break;
default:
$this->_options = array('lang' => 'zh_TW.UTF8', 'domain' => 'test');
break;
}

$this->setApplicationLocale();
}

/**
* 设置应用程序语言包的参数，放在$this->_options中
* @param mixed $options
* @return void
*/
public function setOptions($options) {
if (!emptyempty($options)) {
foreach ($options as $key => $option) {
$this->_options[$key] = $option;
}
}
}

/**
* 设置应用程序语言包
* @access public
* @return void
*/
public function setApplicationLocale() {
putenv('LANG='.$this->_options['lang']);
putenv('LANGUAGE='.$this->_options['lang']);
setlocale(LC_ALL, $this->_options['lang']);
bindtextdomain($this->_options['domain'], PROJECTDIR.'/locale/');
textdomain($this->_options['domain']);
bind_textdomain_codeset($this->_options['domain'], 'UTF-8');
}

}

?>

使用方法：

view plaincopy to clipboardprint?
$lang = 'zh_TW';
$locale = new Locale($lang);

















根据上述提供的例子，再加上自己动手制作的经历，有以下笔记：

1.我用的是Smarty-3.0.8 版本，上面这个“块函数”

$smarty->register_block('t', 'smarty_translate');
已过时，即不存在了，要改为

$smarty->registerPlugin("block",'t', 'smarty_translate');

它的作用是把smarty模板中的 <{t}>*** <{/t}> 当作块函数使。

2.把以命令行形式生成的*.c文件过程，改成了用http方法页面的形式生成，调整tsmarty2c.php 文件如下：

访问地址如下：http://localhost/wjy_ws_zoo/Server/tsmarty2c.php

<?php
#!/usr/local/bin/php -qn
/**
* tsmarty2c.php - rips gettext strings from smarty template
*
* ------------------------------------------------------------------------- *
* This library is free software; you can redistribute it and/or *
* modify it under the terms of the GNU Lesser General Public *
* License as published by the Free Software Foundation; either *
* version 2.1 of the License, or (at your option) any later version. *
* *
* This library is distributed in the hope that it will be useful, *
* but WITHOUT ANY WARRANTY; without even the implied warranty of *
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU *
* Lesser General Public License for more details. *
* *
* You should have received a copy of the GNU Lesser General Public *
* License along with this library; if not, write to the Free Software *
* Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA *
* ------------------------------------------------------------------------- *
*
* This command line script rips gettext strings from smarty file, and prints them to stdout in C format,
* that can later be used with the standard gettext tools.
*
* Usage:
* ./tsmarty2c.php <filename or directory> <file2> <..> > smarty.c
*
* If a parameter is a directory, the template files within will be parsed.
*
* @package smarty-gettext
* @version $Id: tsmarty2c.php,v 1.2 2004/04/30 11:40:22 sagi Exp $
* @link http://smarty-gettext.sf.net/ * @author Sagi Bashari <sagi@boom.org.il>
* @copyright 2004 Sagi Bashari
*/

header("Content-type:text/html;charset=utf-8");

// smarty open tag
$ldq = preg_quote('<{');

// smarty close tag
$rdq = preg_quote('}>');

// smarty command
$cmd = preg_quote('t');

// extensions of smarty files, used when going through a directory
//$extensions = array('tpl');

$extensions = array('html');

$echotext="";

// "fix" string - strip slashes, escape and convert new lines to \n
function fs($str)
{
$str = stripslashes($str);
$str = str_replace('"', '\"', $str);
$str = str_replace("\n", '\n', $str);
return $str;
}

// rips gettext strings from $file and prints them in C format
function do_file($file)
{
global $echotext;

$content = @file_get_contents($file);

if (empty($content)) {
return;
}

global $ldq, $rdq, $cmd;

preg_match_all("/{$ldq}\s*({$cmd})\s*([^{$rdq}]*){$rdq}([^{$ldq}]*){$ldq}\/\\1{$rdq}/", $content, $matches);

for ($i=0; $i < count($matches[0]); $i++) {
if (preg_match('/plural\s*=\s*["\']?\s*(.[^\"\']*)\s*["\']?/', $matches[2][$i], $match)) {
//print 'ngettext("'.fs($matches[3][$i]).'","'.fs($match[1]).'",x);'."\n";
$echotext.='ngettext("'.fs($matches[3][$i]).'","'.fs($match[1]).'",x);'."\n";
} else {
//print 'gettext("'.fs($matches[3][$i]).'");'."\n";
$echotext.='gettext("'.fs($matches[3][$i]).'");'."\n";
}
}
}

// go through a directory
function do_dir($dir)
{
$d = dir($dir);

while (false !== ($entry = $d->read())) {
if ($entry == '.' || $entry == '..') {
continue;
}

$entry = $dir.'/'.$entry;

if (is_dir($entry)) { // if a directory, go through it
do_dir($entry);
} else { // if file, parse only if extension is matched
$pi = pathinfo($entry);

if (isset($pi['extension']) && in_array($pi['extension'], $GLOBALS['extensions'])) {
do_file($entry);
}
}
}

$d->close();
}

/*
for ($ac=1; $ac < $_SERVER['argc']; $ac++) {
if (is_dir($_SERVER['argv'][$ac])) { // go through directory
do_dir($_SERVER['argv'][$ac]);
} else { // do file
do_file($_SERVER['argv'][$ac]);
}
}
*/

//do_file('d:/php/xampp/htdocs/wjy_ws_zoo/Server/module/test/views/index.html');
//do_dir('d:/php/xampp/htdocs/wjy_ws_zoo/Server/module/test/views');

do_dir('./module/test/views');
writefile($echotext);
echo $echotext;

function writefile($writetext,$filename='default.c', $openmod='w') {
if(@$fp = fopen($filename, $openmod)) {
flock($fp, 2);
fwrite($fp, $writetext);
fclose($fp);
return true;
} else {
//log_runlog('error', "File: $filename write error.");
print("write error");
return false;
}
}

?>

模板文件如下：

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>无标题文档</title>
</head>

<body>
<a href=”http://sourceforge.net/projects/smarty-gettext/”><{t}>点击下载插件<{/t}></a>
<a href=”http://sourceforge.net/projects/smarty-gettext/”><{t}>哈哈<{/t}></a>
<a href=”http://sourceforge.net/projects/smarty-gettext/”><{t}>哦哦<{/t}></a>
<a href=”http://sourceforge.net/projects/smarty-gettext/”><{t}>嘻嘻<{/t}></a>
<a href=”http://sourceforge.net/projects/smarty-gettext/”><{t}>拜拜罗<{/t}></a>
</body>
</html>

届时项目目录下即有个 default.c 文件

其他笔记如下：

1.制作全局的多国语言配置信息（现在的情况是把 中文 翻译成 英文）

//多国语言配置 by wenjianbao
putenv ('LANG=en_US' );
setlocale ( LC_ALL, 'en_US' );
$domain = 'default' ; //定义要用的语言文件名称
bindtextdomain ( $domain , dirname(__FILE__).'/locale' ); //设置某个域的mo文件路径 // 设置mo文件的路径，这里的路径为 locale/en_US/LC_MESSAGES/default.mo
bind_textdomain_codeset($domain , 'UTF-8' ); //设置mo文件的编码为UTF-8
textdomain($domain );//设置gettext()函数从哪个域去找mo文件

2.通过php文件：http://localhost/wjy_ws_zoo/Server/tsmarty2c.php
把模板文件夹“\module\test\views\”内的所有的*.html文件生成default.c文件

3.把default.c文件生成default.mo文件
xgettext -d default default.c --from-code=utf-8

4.编译default.mo文件
msgfmt -o default.mo default.po

5.把default.po文件拷贝到 “locale/en_US/LC_MESSAGES/” 文件夹下