6多语言
未知
2021-07-04 11:45:20
0

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

开启和加载语言包

默认系统会加载默认语言包,但如果需要多语言自动侦测及自动切换,你需要在全局的中间件定义文件中添加中间件定义:

'think\middleware\LoadLangPack',
复制

默认情况下,系统载入的是配置的默认语言包,并且不会自动侦测当前系统的语言。多语言相关的设置在lang.php配置文件中进行设置。

默认语言由default_lang配置参数设置,系统默认设置为:

// 默认语言
'default_lang'    => 'zh-cn',
复制

启用中间件后,系统会自动侦测和多语言自动切换,可以在配置文件设置自动侦测的多语言变量名:

// 自动侦测的GET变量名
'detect_var' => 'lang',
复制

开启自动侦测后会会首先检查请求的URL或者Cookie中是否包含语言变量,然后根据HTTP_ACCEPT_LANGUAGE自动识别当前语言(并载入对应的语言包)。

V6.0.3+版本开始支持通过Header方式自动侦测多语言

如果在自动侦测语言的时候,希望设置允许的语言列表,不在列表范围的语言则仍然使用默认语言,可以配置:

// 设置允许的语言
'allow_lang_list'    =>    ['zh-cn', 'en-us']
复制

如果希望使用Cookie保存语言,可以设置

// 使用Cookie保存
'use_cookie' => true,
// Cookie保存变量
'cookie_var' => 'think_lang',
复制

设置后,自动检测的语言会通过Cookie记录下来,下次则直接通过Cookie判断语言。

语言变量定义

语言变量的定义,只需要在需要使用多语言的地方,写成:

Lang::get('add user error');
// 使用系统封装的助手函数
lang('add user error');
复制

也就是说,字符串信息要改成Lang::get方法来表示。

语言定义一般采用英语来描述。

语言文件定义

自动加载的应用语言文件位于:

// 单应用模式
app\lang\当前语言.php
// 多应用模式
app\应用\lang\当前语言.php
复制

语言包文件支持多种格式,包括php数组、yaml格式及json格式(V6.0.4+)。

如果你还需要加载其他的语言包,可以通过extend_list设置,例如:

'extend_list'    =>    [
    'zh-cn'    => [
        app()->getBasePath() . 'lang\zh-cn\app.php',
        app()->getBasePath() . 'lang\zh-cn\core.php',
    ],
]
复制

目前核心框架仅内置zh-cn语言包,如果需要其它语言的提示,可以通过扩展语言包的方式自行加载。

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

return [
     'hello thinkphp'  => '欢迎使用ThinkPHP',
     'data type error' => '数据类型错误',
];
复制

通常多语言的使用是在控制器里面,但是模型类的自动验证功能里面会用到提示信息,这个部分也可以使用多语言的特性。

如果使用了多语言功能的话(假设,我们在当前语言包里面定义了' lang_var'=>'标题必须!'),就可以使用下面的字符串来替代原来的错误提示。

{%lang_var}
复制

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

{$Think.lang.lang_var}
复制

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

变量传入支持

语言包定义的时候支持传入变量,有两种方式

使用命名绑定方式,例如:

'file_format'    =>    '文件格式: {:format},文件大小:{:size}',
复制

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

{:lang('file_format',['format' => 'jpeg,png,gif,jpg','size' => '2MB'])}
复制

第二种方式是使用格式字串,如果你需要使用第三方的翻译工具,建议使用该方式定义变量。

'file_format'    =>    '文件格式: %s,文件大小:%d',
复制

在模板中输出多语言的方式更改为:

{:lang('file_format',['jpeg,png,gif,jpg','2MB'])}
复制

语言分组

首先你需要在lang.php配置文件中开启语言分组,

// 开启多语言分组
'allow_group'    =>    true
复制

然后你可以在定义多语言的时候使用分组定义

return [
    'user'    =>    [
         'welcome'  => '欢迎回来',
         'login' => '用户登录',
         'logout' => '用户登出',
    ]
];
复制

然后使用下面的方式获取多语言变量

Lang::get('user.login');
lang('user.login');
复制

上一篇:6Cookie

下一篇:6上传

相关内容

拼多多购物优惠券,折扣享不...
拼多多购物优惠券丰富多样,可享折扣优惠。多种优惠券类型与获取方式,...
2024-11-20 13:58:10
京东优惠券领不停,优惠不停...
京东优惠券多样实用,领取便捷,可降低购物成本,并可分享给亲友。优惠...
2024-11-20 12:46:36
拼多多购物优惠券,优惠力度...
拼多多购物优惠券种类多,优惠力度大,可省下不少钱。可通过平台活动、...
2024-11-20 12:00:43
MySQL排序函数的使用
MySQL提供了丰富的排序功能,可通过ORDER BY子句、CAS...
2024-11-19 23:46:38
Empty directo...
Empty directories is not supporte...
2024-07-25 09:15:46
tp5和layui表单提交...
form class=layui-form layui-form-...
2024-04-09 14:45:31

热门资讯

tp6开发规范 命名规范 请理解并尽量遵循以下命名规范,可以减少在开发过程中出现不必要的错误。 ThinkPHP6....
6高级查询 快捷查询 快捷查询方式是 一种多字段相同查询条件 的简化写法,可以进一步简化查询条件的写法,在多个字...
tp6多应用提示控制器不存在:... 第一个情况是没有使用composer安装扩展。 如果要使用多应用模式, 你需要win+r,cmd指针...
6配置 配置目录 单应用模式 对于单应用模式来说,配置文件和目录很简单,根目录下的 config 目录下面就...
6异常处理 和PHP默认的异常处理不同,ThinkPHP抛出的不是单纯的错误信息,而是一个人性化的错误页面。 异...
6swoole 本篇内容主要讲述了最新的 think-swoole 扩展的使用。目前仅支持Linux环境或者MacO...
6助手函数 助手函数 系统为一些常用的操作方法封装了助手函数,便于使用,包含如下: 助手函数 描述 abort ...
6查询表达式 查询表达式 查询表达式支持大部分的SQL查询语法,也是 ThinkPHP 查询语言的精髓,查询表达式...
6路由参数 路由参数 路由分组及规则定义支持指定路由参数,这些参数主要完成路由匹配检测以及后续行为。 路由参数可...
6查询 模型查询和数据库查询方法的区别主要在于,模型中的查询的数据在获取的时候会经过获取器的处理,以及更加对...