В предыдущей части Kohana 3: Первые шаги мы научились устанавливать фреймворк из репозитария, настраивать index.php, создавать контроллер, создавать метод вызываемый по умолчанию и немного общаться с внешним миром. В этой части мы познакомимся с отображениями (views), научимся передавать данные в отображения, работать с вложенными отображениями и переменными отображений.
Используется несколько вариантов перевода View на русский язык, в основном используется три: представление, вид или отображение. Я буду использовать отображение, мне оно привычнее.
Для начала перейдём в каталог с нашей копией репозитария фреймворка Kohana. Если в каталоге application отсутствует каталог views мы создадим его, а в нём создадим подкаталог pages. Теперь в каталоге pages создадим файл first.php со следующим содержимым:
<html>
<head>
<title>Привет!</title>
</head>
<body>
<h1>Это моё первое отображение</h1>
</body>
</html>
В контроллере first.php изменим содержимое метода action_index(), на следующие:
public function action_index()
{
$this->request->response = View::factory('pages/first');
}
Сохраним его и откроем http://kohana.local/first/ в браузере. Вы должны увидеть "Это моё первое отображение".
Код используемый в нашем методе очень простой, мы использовали метод "Factory" класса "View" для загрузки файла application/views/pages/first.php, сформировали его и вывели. Вернёмся к application/views/pages/first.php и добавим в него:
<?php echo $content;?>
После тэга h1. Ваше отображение должно выглядеть так:
<html>
<head>
<title>Привет!</title>
</head>
<body>
<h1>Это моё первое отображение</h1>
<?php echo $content;?>
</body>
</html>
Если мы обновим страницу браузера, то увидим сообщение об ошибке о неопределённой переменной. Давайте исправим это. Изменим содержимое метода action_index() контроллера на следующее:
public function action_index()
{
$view = View::factory('pages/first');
$view->content = 'У нас есть данные!';
$this->request->response = $view->render();
}
Теперь, если мы обновим страницу браузера, то увидим "Это моё первое отображение" и ниже "У нас есть данные!". Рассмотрим каждую строку кода метода.
$view = View::factory('pages/first');
Здесь мы загружаем файл ("application/views/pages/first.php") в контроллер отображения.
$view->content = 'У нас есть данные!';
Присваиваем переменной отображения "content" значение "У нас есть данные!", переменная и значение будут доступны в отображении.
$this->request->response = $view->render();
Формируем и выводим страницу.
Как видите, всё достаточно просто, но есть ещё один вариант решения. Мы могли бы использовать следующий код для метода:
public function action_index()
{
$data['content'] = 'У нас есть данные!';
$view = View::factory('pages/first', $data);
$this->request->response = $view->render();
}
Обычно для передачи переменных в шаблон используются массивы в которых ключ это имя переменной, а значение, собственно значение переменной. Но мы ещё не закончили, вот ещё два способа сделать тоже самое:
public function action_index()
{
$view = View::factory('pages/first')
->set('content','У нас есть данные!');
$this->request->response = $view->render();
}
Выше использовался метод цепи, используя этот метод можно назначить все переменные отображения. И четвертый способ:
public function action_index()
{
$content = 'У нас есть данные!';
$view = View::factory('pages/first')
->bind('content', $content);
$this->request->response = $view->render();
}
В выше приведённом способе мы использовали метод bind класса View, как вы заметили его тоже можно использовать с методом цепи. Метод bind немного отличается от set, он не устанавливает значение переменной отображения, а создаёт ссылку на переменную. Таким образом для изменения содержимой отображения content на нужно просто изменить содержимое переменной $content.
Если мы внесём следующие изменения:
public function action_index()
{
$content = 'У нас есть данные!';
$view = View::factory('pages/first')
->bind('content', $content);
$content = 'Наши данные изменились';
$this->request->response = $view->render();
}
То вместо "У нас есть данные!", мы увидим "Наши данные изменились".
Давайте сделаем отображение в отображении! Создадим в каталоге "application/views/" каталог с именем "blocks". Далее создадим в этом каталоге файл с именем first_inner.php и следующим содержимым:
<h3>Это вложенное отображение</h3>
Теперь откроем файл application/views/pages/first.php и добавим в него следующие строки:
<?php echo View::factory('blocks/first_inner')->render(); ?>
Наш файл отображения должен стать примерно таким:
<html>
<head>
<title>Привет!</title>
</head>
<body>
<h1>Это моё первое отображение</h1>
<?php echo $content;?>
<?php echo View::factory('blocks/first_inner')->render(); ?>
</body>
</html>
Итак, если мы обновим страницу браузера, то увидим то же, что было раньше и "Это вложенное отображение" добавленное в конце. Это удобно использовать для статического контента, но мы не сможем использовать переменные, непосредственно в этом отображении. Давайте это исправим. Для начала вернёмся к нашему контроллеру ("application/classes/controllers/first.php") и отредактируем метод "action_index":
public function action_index()
{
$first_inner['content'] = 'У нас есть ещё данные';
$first['content'] = 'У нас есть данные!';
$first['first_inner'] = View::factory('blocks/first_inner', $first_inner)
->render();
$view = View::factory('pages/first', $first);
$this->request->response = $view->render();
}
Здесь будет сформировано отображение, которое будет помещено в массив переменных из которых будет сформировано главное отображение. Если вы заметили, то я сначала сформировал вложенное отображение и поместил его в массив переменных главного отображения, а затем сформировал и вывел главное отображение. Далее нам нужно изменить главное отображение ("application/views/pages/first"). Вставим эту строку вместо той, где выводилось вложенное отображение:
<?php echo $first_inner; ?>
Наше отображение должно выглядеть так:
<html>
<head>
<title>Привет!</title>
</head>
<body>
<h1>Это моё первое отображение</h1>
<?php echo $content; ?>
<?php echo $first_inner; ?>
</body>
</html>
Теперь внесём изменения во вложенное отображение ("application/views/blocks/first_inner.php"):
<h3>Это вложенное отображение</h3> <?php echo $content; ?>
Если мы обновим страницу браузера, то увидим следующее:
Это моё первое отображение У нас есть данные! Это вложенное отображение У нас есть ещё данные
Выглядит круто, теперь мы можем делать более удобные модульные отображения. Давайте добавим глобальные переменные, которые будут доступны в наших отображениях. Вернёмся к контроллеру ("application/classes/controllers/first.php") и добавим в начало метода "action_index()" следующую строку:
View::set_global('x', 'Это глобальная переменная');
Теперь наш метод выглядит так:
public function action_index()
{
View::set_global('x', 'Это глобальная переменная');
$first_inner['content'] = 'У нас есть ещё данные';
$first['content'] = 'У нас есть данные!';
$first['first_inner'] = View::factory('blocks/first_inner', $first_inner)
->render();
$view = View::factory('pages/first', $first);
$this->request->response = $view->render();
}
Добавим в оба наши отображения строку:
<br/><?php echo $x;?>
После обновления страницы браузера мы увидим надпись "Это глобальная переменная" в двух местах на странице. Как вы видите это довольно удобно, если какие-то данные необходимо вывести в нескольких отображениях. В основном мы используем метод set_global класса View, это делает переменную доступной во всех копиях объекта View. Так же можно использовать метод bind_global для создания ссылки на переменную. Глобальные методы класса View удобно использовать в методе before() контроллера.
P.S. За основу взяты материалы с Inside DealTaker и Unofficial Kohana 3.0 Wiki
Другие части руководства:
- Kohana 3: Установка под Ubuntu
- Kohana 3: Первые шаги (Установка и настройка)
- Kohana 3: Работа с отображениями
- Kohana 3: Работа с контроллерами
- Kohana 3: Работа с моделью
2 комментария:
Отличия от kohana 3.1:
$this->request->response = $view->render(); в 3.1 заменяем на $this->response->body($view->render());
Если неправ - автор поправит, я пока еще учусь.
Вы правы в версии 3.1 класс Request был разделён на два класс Request и Response.
$this->request->response = 'foo';
Было изменено на:
$this->response->body('foo');
Это было указано в руководстве по миграции http://kohanaframework.org/3.1/guide/kohana/upgrading (http://dev-mark.blogspot.com/2011/02/kohana-31_09.html)
Спасибо за ваш комментарий.
Отправить комментарий