ThinkPHP 多语言支持的配置与使用

2017-12-14 09:18:00 2356 2 编辑:深正互联 来源:互联网

pm0460-5195cx.jpg

ThinkPHP内置了对多语言的支持,如果应用项目涉及到国际化,那么可以定义相关的语言包文件以实现多语言支持。这里涉及的多语言支持是指模板语言,数据的多语言转换(翻译)不在这个范畴之内。

在项目配置文件里添加如下参数以开启多语言的支持:

'LANG_SWITCH_ON'

=> true, //开启多语言支持开关

'DEFAULT_LANG' => 'zh-cn', //

默认语言

'LANG_AUTO_DETECT' => true, // 自动侦测语言ThinkPHP会自动判断当前用户的浏览器支持语言来定位该使用何种语言包,如果找不到相关的语言包文件,会使用默认语言。如果浏览器支持多种语言,那么取第一种支持语言。

除了自动侦测当前用户的浏览器语言之外,也可以在URL中指定使用何种语言,详细见下面例子。

与多语言有关的文件包或目录如下:

ThinkPHP系统简体中文语言包:ThinkPHP系统目录/Lang/zh-cn.php

ThinkPHP系统繁体中文语言包:ThinkPHP系统目录/Lang/zh-tw.php

ThinkPHP系统美国英语语言包:ThinkPHP系统目录/Lang/en-us.php

项目简体中文语言包目录:项目目录/Lang/<项目分组/>zh-cn/

项目繁体中文语言包目录:项目目录/Lang/<项目分组/>zh-tw/

项目美国英语中文语言包目录:项目目录/Lang/<项目分组/>en-us/

如果有更多语言,可以按照例子依次创建文件或目录即可。

项目多语言实例

下面以一个中英双语的例子来看项目多语言支持的具体实现。

在项目目录/Lang/zh-cn/ 下创建 common.php 文件,并在内设定简体中文语言定义:

    return array(

    'welcome'=>'欢迎使用 ThinkPHP !',

    'message'=>'这是一条测试消息!',

    );

在 项目目录/Lang/en-us/ 下创建

common.php 文件,并在内设定美国英语语言定义:

    return array(

    'welcome'=>'Welcome to ThinkPHP!',

    'message'=>'This is a test message!',

    );

在操作中(如 Index 模块 lang

操作)中:

    public function lang(){

    $this->assign('message', L('message'));

    $this->display();

    }

对应的模板(Tpl/default/Index/lang.html):

{$Think.lang.welcome}

{$message}

切换到: href="http://www.php1.cn/"> href="http://www.php1.cn/">

当我们访问该操作时,系统会根据当前浏览器语言来自动获取对应的语言包内容。上面的例子中,直接在模板中显示的内容使用

{$Think.lang.welcome} 来输出,而在操作中获取语言包内容时,需要使用 L 快捷方法。当点击 English 链接时,由于 URL 中传入了

l=en-us 参数,系统会获取对应的英语语言包,从而显示:

Welcome to ThinkPHP!

This is a test message!

L 快捷方法

L 快捷方法用于获取和设置语言定义,语法如下:

L(name,value)如果 name 和 value 参数都存在时,表示设定语言变量名 name=value;当 value 省略时,表示获取 name语言变量对应的值,若 name 未定义时,将 name以大写返回。

模块定义语言包

当项目比较大时,可能需要按照模块来定义语言包。按照模块定义语言包时,语言包名字就是对应的模块名字(小写)。如给

User 模块定义语言包时,对应的语言包文件为:项目目录/Lang/zh-cn/user.php。

对模块定义语言包时,使用上与上面普通定义方式完全一致。当模块语言包与普通语言包有相同的语言定义项时,模块语言包的定义会覆盖普通方式的定义。

项目模型里使用语言包

项目多语言支持中除了模板和模块操作要用到语言包之外,在模型类里也可能需要用到语言包(如自动验证的提示信息)。要在项目模型里使用语言包,只需将原来写入验证规则的提示信息更改为:

array('title','require','{%vali_title}',1),

vali_title

是项目语言包里面定义的语言变量,如同例子上面定义 welcome 和 message 一样。如果想测试多语言的效果,可以在表单提交的时候传入 l

参数:

method="post">

注意:在提交表单里不可像前面列子使用 /Article/insert?l=en-us

这种参数传入形式,否则会导致“表单令牌错误”。

由于 ThinkPHP 具有自动检测浏览器使用语言的功能,因此一般不需要在 URL 中传入l参数,当然这不是绝对的,可以根据实际情况来决定。 

本站文章均为深正网站建设摘自权威资料,书籍,或网络原创文章,如有版权纠纷或者违规问题,请即刻联系我们删除,我们欢迎您分享,引用和转载,但谢绝直接搬砖和抄袭!感谢...
关注深正互联

15

技术从业经验

多一份方案,会有收获...

联系深正互联,免费获得专属《策划方案》及报价

在线咨询 微信交谈
拒绝骚扰,我们只想为给您带来一些惊喜...
多一份免费策划方案,总有益处。

请直接添加技术总监微信联系咨询