lang()
作用:获取或设置语言提示消息。
语法: mixed lang([string $key][, ...])
参数:
$key
设置消息名称,使用点语法,如 mod.missingArguments;
也可以设置为一个关联数组来设置运行时的提示消息。
更多参数,用来为消息名称提供替换参数。
返回值:
如果未提供任何参数,则返回所有语言提示消息组成的数组。
如果提供 $key
参数为字符串,则返回对应的语言提示消息,可能是一条文本,也可能是一个数组,取决于 $key
访问的深度。
如果提供 $key
参数为关联数组,则设置运行时语言提示并返回 true
。
如果除了 $key
参数外,还提供了更多的参数,那么这些参数将用来替换消息中对应的用 {}
扣起来的关键字。
说明:
ModPHP 的语言包是三层模式,即默认语言、用户语言和运行时语言,优先级从右到左。默认语言包存放在 __ROOT__/mod/lang/
目录下,用户语言包存放在 __ROOT__/user/lang/
目录下。通过设置 config('mod.language')
来确定系统运行时加载的语言包,比如设置为 zh_CN
,则加载 zh_cn.php
语言包。
消息中可以使用花括号 {}
来接收 lang()
函数提供的其他参数,并将其替换后返回。比如 mod.noData = '无{module}数据。'
,那么在使用 lang('mod.noData', '用户')
时,其返回值将是“无用户数据。
”。
如果语言包中不存在 $key
参数所访问的消息,则将 $key
原样返回。
示例:
<?php
echo lang('user.notExists'); //将输出 所请求的用户不存在。
lang(array( //设置运行时语言提示
'user.notExists' => '所请求的用户不存在。'
));