This repository has been archived on 2024-04-08. You can view files and clone it, but cannot push or open issues or pull requests.
khosb/includes/kohana/modules/userguide/guide/zh-cn/using.messages.md
2011-05-03 09:49:01 +10:00

1.5 KiB

消息的基本使用

Kohana 消息(messages) 是一种友好化短小的词或短语的字符串,通常被叫做 "key"。消息通过 [Kohana::message] 方法调用访问并返回整个消息组或者单个消息。

举个简单的例子,当用户没有登录并试图访问一个需要验证的页面,通常会一个类似"你必须登录后才能访问此页面"的提示,而此消息可以保存在 auth 文件的 'must_login' 的键值中:

$message = Kohana::message('auth', 'must_login');

消息并不能直接翻译,如果想翻译一个消息,你需要配合使用翻译函数:

$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'  => '你没有访问此页面的权限',
);

消息文件有些类似于配置文件,它们都可以合并在一起。这意味着所有的消息都可以设置为一个数组并保存在 'auth' 文件之中。因此当你需要一个新的 'auth' 文件而没有必要创建多个重复文件。