27 lines
1.5 KiB
Markdown
27 lines
1.5 KiB
Markdown
|
# 消息的基本使用
|
||
|
|
|
||
|
|
Kohana 消息(messages) 是一种友好化短小的词或短语的字符串，通常被叫做 "key"。消息通过 [Kohana::message] 方法调用访问并返回整个消息组或者单个消息。
|
||
|
|
|
||
|
|
举个简单的例子，当用户没有登录并试图访问一个需要验证的页面，通常会一个类似"你必须登录后才能访问此页面"的提示，而此消息可以保存在 auth 文件的 'must_login' 的键值中:
|
||
|
|
|
||
|
|
$message = Kohana::message('auth', 'must_login');
|
||
|
|
|
||
|
|
消息并不能直接翻译，如果想翻译一个消息，你需要配合使用[翻译函数](using.translation):
|
||
|
|
|
||
|
|
$translated = __(Kohana::message('auth', 'must_login'));
|
||
|
|
|
||
|
|
[!!] 在 Kohana v2 版本中，消息系统是可以翻译的，尽管如此，我们还是强烈推荐大家使用新的翻译系统代替消息，因为当翻译不存时它可以提供可读性文本。
|
||
|
|
|
||
|
|
## 消息文件
|
||
|
|
|
||
|
|
所有的消息文件都是保存在 `messages/` 目录下的纯 PHP 文件的配对数组:
|
||
|
|
|
||
|
|
<?php defined('SYSPATH') or die('No direct script access.');
|
||
|
|
|
||
|
|
return array(
|
||
|
|
'must_login' => '你必须登录后才能访问此页面',
|
||
|
|
'no_access' => '你没有访问此页面的权限',
|
||
|
|
);
|
||
|
|
|
||
|
|
消息文件有些类似于[配置文件](using.configuration#config-files)，它们都可以合并在一起。这意味着所有的消息都可以设置为一个数组并保存在 'auth' 文件之中。因此当你需要一个新的 'auth' 文件而没有必要创建多个重复文件。
|