多语言支持_专题_帮助文档_Thinkphp手册

多语言支持_专题_帮助文档_Thinkphp手册

ThinkPHP内置多语言支持,如果你的应用涉及到国际化的支持,那么可以定义相关的语言包文件。任何字符串形式的输出,都可以定义语言常量。

要启用多语言功能,需要配置开启多语言行为,在应用的配置目录下面的行为定义文件tags.php中,添加:

表示在app_begin标签位置执行多语言检测行为。

要开启语言包功能,需要开启

其他的配置参数包括:

可以为项目定义不同的语言文件,框架的系统语言包目录在系统框架的Lang目录下面,每个语言都对应一个语言包文件,系统默认只有简体中文语言包文件zh-cn.php和英文语言包en-us.php ,如果要增加繁体中文zh-tw或者其他语言支持,只要增加相应的语言定义文件。

语言包的使用由系统自动判断当前用户的浏览器支持语言来定位,如果找不到相关的语言包文件,会使用默认的语言。如果浏览器支持多种语言,那么取第一种支持语言。

ThinkPHP的多语言支持是指的是模板多语言支持,数据的多语言转换(翻译)不在这个范畴之内。ThinkPHP具备语言包定义、自动识别、动态定义语言参数的功能。并且可以自动识别用户浏览器的语言,从而选择相应的语言包(如果有定义)。例如:

我们在语言包里面增加了ADD_USER_ERROR语言配置变量的话,在程序中的写法就要改为:

也就是说,字符串信息要改成L方法和语言定义来表示。

应用语言包文件位于应用公共模块下的Lang目录,并且按照语言类别分子目录存放,在执行的时候系统会自动加载,无需手动加载。

具体的语言包文件命名和位置如下:

语言包语言文件位置
应用语言包应用公共目录/Lang/语言文件.php
模块语言包模块目录/Lang/语言文件.php
控制器语言包模块目录/Lang/语言目录/控制器名(小写).php

以当前模块为Home、当前语言为zh-cn为例,我们可以读取语言包的顺序如下(如果没有定义则不读取):

语言子目录采用浏览器的语言命名(全部小写)定义,例如English (United States) 可以使用en-us作为目录名。如果项目比较小,整个项目只有一个语言包文件,那可以定义应用的公共语言文件即可,而无需按照模块分开定义。

语言文件定义

ThinkPHP语言文件定义采用返回数组方式:

也可以在程序里面动态设置语言定义的值,使用下面的方式:

通常多语言的使用是在控制器里面,但是模型类的自动验证功能里面会用到提示信息,这个部分也可以使用多语言的特性。例如原来的方式是把提示信息直接写在模型里面定义:

如果使用了多语言功能的话(假设,我们在当前语言包里面定义了' lang_var'=>'标题必须!'),就可以这样定义模型的自动验证

如果要在模板中输出语言变量不需要在控制器中赋值,可以直接使用模板引擎特殊标签来直接输出语言定义的值:

0

可以输出当前选择的语言包里面定义的 lang_var语言定义。

变量传入支持

3.2.2版本开始,语言包定义的时候支持传入变量,例如:

1

在模板中输出语言字符串的时候传入变量值即可:

2

未经允许不得转载:淘淘源码吧 » 多语言支持_专题_帮助文档_Thinkphp手册