27 lines
2.6 KiB
Markdown
27 lines
2.6 KiB
Markdown
# Основы
|
||
|
||
Сообщения Kohana - это понятные человеку строки, представленные в виде короткого слова или фразы, называемой "ключ". Сообщения извлекают с помощью метода [Kohana::message], который возвращает либо группу сообщений целиком, либо отдельное сообщение.
|
||
|
||
Например, когда пользователь не вошел в систему и пытается зайти на страницу, требующую аутентифицикации, должна быть отображена ошибка типа "Вы должны залогиниться для доступа к данной странице". Это сообщение может храниться в файле `auth` под ключом `must_login`:
|
||
|
||
$message = Kohana::message('auth', 'must_login');
|
||
|
||
Сообщения не переводятся автоматически. Для осуществления перевода используйте [функции перевода](using.translation):
|
||
|
||
$translated = __(Kohana::message('auth', 'must_login'));
|
||
|
||
[!!] В Kohana v2 система сообщений использовалась для перевода. Однако, рекомендуется использовать новую систему перевода вместо системы сообщений, так как она выведет понятный текст даже если перевод не найден.
|
||
|
||
## Файлы сообщений
|
||
|
||
Все файлы сообщений являются PHP-файлами, хранимыми в директории `messages/`, и возвращают ассоциативные массивы:
|
||
|
||
<?php defined('SYSPATH') or die('No direct script access.');
|
||
|
||
return array(
|
||
'must_login' => 'Вы должны залогиниться для доступа к этой странице',
|
||
'no_access' => 'У Вас недостаточно прав для доступа к странице',
|
||
);
|
||
|
||
Файлы сообщений похожи на [файлы настроек](using.configuration#config-files) - они тоже собираются вместе. Это означает, что все сообщения, хранимые в файлах с именем `auth`, будут объединены в один массив, так что нет необходимости дублировать все сообщения, если Вы создаете новый файл `auth`.
|