阅读(4136) (9)

lang()

2017-06-13 17:26:40 更新

作用:获取或设置语言提示消息。

语法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' => '所请求的用户不存在。'
));