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 和closetag 必须与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
[*]<?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');
[*] }
[*]
[*]}
[*]
[*]?>
使用方法：
[*]$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, MA02111-1307USA *
* ------------------------------------------------------------------------- *
*
* 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); $i++) {
if (preg_match('/plural\s*=\s*["\']?\s*(.[^\"\']*)\s*["\']?/', $matches[$i], $match)) {
//print 'ngettext("'.fs($matches[$i]).'","'.fs($match).'",x);'."\n";
$echotext.='ngettext("'.fs($matches[$i]).'","'.fs($match).'",x);'."\n";
} else {
//print 'gettext("'.fs($matches[$i]).'");'."\n";
$echotext.='gettext("'.fs($matches[$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/” 文件夹下
页:
[1]