Азы работы с Zend Framework (2/3) – Реализация приложения

Доброго времени суток всем . Сегодня мы продолжим наш практический экскурс в один из самых продвинутых и популярных PHP фрэймворков – Zend Framework. В сегодняшнем уроке мы реализуем простое Zend приложение, а именно: создадим layout, научимся взаимодействовать с моделями (Базами данных), формами и прочими фичами.

sourse

Итак, на данный момент у вас должно быть создано Zend Framework приложение, состоящее из одного контроллера – Index, и четырёх action – index, add, edit, delete.

Создание базы данных и таблицы

Для того чтобы нам было с чем работать, создадим таблицу и заполним её информацией:

01 CREATE DATABASE `zfdemo` ;
02 USE `zfdemo` ;
03 CREATE TABLE IF NOT EXISTS `movies` (
04 `id` int(11) NOT NULL AUTO_INCREMENT,
05 `director` varchar(100) NOT NULL,
06 `title` varchar(100) NOT NULL,
07 PRIMARY KEY (`id`)
08 ) ENGINE=InnoDB DEFAULT CHARSET=utf8 AUTO_INCREMENT=6 ;
09 INSERT INTO `movies` (`id`, `director`, `title`) VALUES
10 (1, 'Питер Джексон', 'Властелин Колец'),
11 (2, 'Кристофер Нолан', 'Начало'),
12 (3, 'Тодд Филлипс', 'Мальчишник в Вегасе'),
13 (4, 'Кристофер Нолан', 'Темный рыцарь'),
14 (5, 'Эндрю Стентон', 'ВАЛЛ-И');

Для подключения к базе данных вы обычно пользовались файлом db.php или что-то вроде этого. В Zend Framework для этих целей существует отдельный файл — application.ini, который находится в каталоге вашего проекта zfdemo\application\configs\application.ini. Перейдите в сегмент development ([development : production]) и вставьте следующий код:

1 resources.db.adapter = PDO_MYSQL
2 resources.db.params.host = localhost
3 resources.db.params.username = root
4 resources.db.params.password = sql4root
5 resources.db.params.dbname = zfdemo

PDO_MYSQL – это адаптер, который мы будем использовать для работы с базами данных. Если вы когда-либо работали с базами данных, то следующие параметры будут вам знакомы.

Теперь для того чтобы взаимодействовать с только что созданной таблицей, нам необходимо создать модель. Сделаем мы это при помощи Zend Tool (установка и настройка данного инструмента подробно описана в прошлой статье). Откройте консоль или командную строку. Перейдите в каталог вашего проекта (обязательно). Теперь наберите команду:

1 zf create db-table Movies movies

После того как вы выполните данную операцию, у вас будет создан новый каталог (application/models/DbTable) и файл Movies.php. Откройте данный файл и заполните его следующим содержимым:

01 <?php
02
03 class Application_Model_DbTable_Movies extends Zend_Db_Table_Abstract
04 {
05 // Имя таблицы, с которой будем работать
06 protected $_name = 'movies';
07
08 // Метод для получения записи по id
09 public function getMovie($id)
10 {
11 // Получаем id как параметр
12 $id = (int)$id;
13
14 // Используем метод fetchRow для получения записи из базы.
15 // В скобках указываем условие выборки (привычное для вас where)
16 $row = $this->fetchRow('id = ' . $id);
17
18 // Если результат пустой, выкидываем исключение
19 if(!$row) {
20 throw new Exception("Нет записи с id - $id");
21 }
22 // Возвращаем результат, упакованный в массив
23 return $row->toArray();
24 }
25
26 // Метод для добавление новой записи
27 public function addMovie($director, $title)
28 {
29 // Формируем массив вставляемых значений
30 $data = array(
31 'director' => $director,
32 'title' => $title,
33 );
34
35 // Используем метод insert для вставки записи в базу
36 $this->insert($data);
37 }
38
39 // Метод для обновления записи
40 public function updateMovie($id, $director, $title)
41 {
42 // Формируем массив значений
43 $data = array(
44 'director' => $director,
45 'title' => $title,
46 );
47
48 // Используем метод update для обновления записи
49 // В скобках указываем условие обновления (привычное для вас where)
50 $this->update($data, 'id = ' . (int)$id);
51 }
52
53 // Метод для удаления записи
54 public function deleteMovie($id)
55 {
56 // В скобках указываем условие удаления (привычное для вас where)
57 $this->delete('id = ' . (int)$id);
58 }
59 }

Мы только что создали модель с очень длинным названием Application_Model_DbTable_Movies. Такое наименование необходимо согласно правилам построения проекта. Дело в том, что когда мы будем создавать объект данной модели, Zend Framework должен определить какой файл ему подключить. Данное название класса говорит о том, что модель находится в каталоге application/models/db-table, а сама модель называется Movies.php. Таким образом, Zend Framework автоматически подключит данную модель.

Если вы обратили внимание, то наша модель наследуется от класса Zend_Db_Table_Abstract. Благодаря этому наследованию мы можем пользоваться методами insert(), update(), delete(), fetchRow(), fetchAll() и многими другими.

Теперь, когда всё необходимое для работы с базой данных готово, приступим к созданию layout.

Создание Layout

Как вы уже поняли из первой статьи, у каждого контроллера есть серия своих action, каждый из которых в свою очередь имеет свой view. Если вы откроете какой-то view, допустим application\views\scripts\index\edit.phtml, то не увидите ни doctype, ни meta тегов… Вы спросите: «Что мне в каждом файле писать doctype?». Ответ — конечно же нет! Для этого в Zend Framework существует Layout.

Откройте консоль или командную строки и перейдите в каталог вашего проекта. Для того чтобы создать layout, наберите следующую команду:

1 zf enable layout

После выполнения данной команды в вашем application.ini появится новая строка:

1 resources.layout.layoutPath = APPLICATION_PATH "/layouts/scripts/"

Ниже этой строки добавьте следующую запись, которая сообщит приложению какой использовать doctype:

1 resources.view.doctype = "XHTML1_STRICT"

Первая строка сообщит Zend Framework, где ему искать layout скрипт. Откройте каталог application/layouts/scripts. В данной папке вы увидите файл layout.phtml. Откройте данный файл и вставьте следующее содержание:

01 <?php
02 // Создаём meta тег Content-Type
03 $this->headMeta()->appendHttpEquiv('Content-Type', 'text/html;charset=utf-8');
04 // Указываем символ разделитель в теге title
05 $this->headTitle()->setSeparator(' - ');
06 // Определяем содержимое тега title
07 $this->headTitle('Уроки по Zend Framework от Ruseller.com');
08
09 // Выводим doctype, который считывается из application.ini
10 echo $this->doctype();
11 ?>
12
13 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">
14 <head>
15 <?php
16 // Выводим meta теги
17 echo $this->headMeta();
18 ?>
19 <?php
20 // Выводим заголовок сайта
21 echo $this->headTitle();
22 ?>
23 <?php
24 // Прикрепляем таблицу стилей
25 echo $this->headLink()->prependStylesheet($this->baseUrl().'/css/site.css');
26 ?>
27 </head>
28 <body>
29 <div id="content">
30 <h1>
31 <?php
32 // Выводим заголовок странице, который будем формировать в каждом view
33 echo $this->escape($this->title);
34 ?>
35 </h1>
36 <?php
37 // Данная запись выводит содержимое view
38 echo $this->layout()->content;
39 ?>
40 </div>
41 </body>
42 </html>

Теперь этот код будет вставляться на каждую страницу, которую мы будем просматривать, а вместо записи echo $this->layout()->content; будет вставляться содержимое, указанное в view (отдельно сформированное содержание каждой страницы). Теперь, когда мы захотим подключить какую-то библиотеку, таблицу стилей или скрипт, нам необходимо будет просто добавить запись в данный файл.

Для того чтобы полностью покончить с оформлением, в каталоге public создайте папку css и файл site.css:

01 body,html {
02 margin: 0 5px;
03 font-family: Verdana,sans-serif;
04 }
05 h1 {
06 font-size: 1.4em;
07 color: #000080;
08 }
09 a {
10 color: #000080;
11 }
12
13 /* Таблица */
14 th {
15 text-align: left;
16 }
17 td, th {
18 padding-right: 5px;
19 }
20
21 /* Форма */
22 form dt {
23 width: 100px;
24 display: block;
25 float: left;
26 clear: left;
27 }
28 form dd {
29 margin-left: 0;
30 float: left;
31 }
32 form #submitbutton {
33 margin-left: 100px;
34 }

Создание формы

Для того чтобы вставлять информацию в базу данных, нам необходимо создать форму, через которую пользователь будет вносить свои данные. Откройте командную строку, перейдите в каталог вашего проекта и наберите следующую команду:

1 zf create form Movie

После выполнения данной команды у вас создастся новый каталог forms, в котором вы найдёте файл Movie.php. Откройте данный файл и вставьте следующее содержание:

01 <?php
02
03 class Application_Form_Movie extends Zend_Form
04 {
05 // Метод init() вызовется по умолчанию
06 public function init()
07 {
08 // Задаём имя форме
09 $this->setName('movie');
10
11 // Создаём элемент hidden c именем = id
12 $id = new Zend_Form_Element_Hidden('id');
13 // Указываем, что данные в этом элементе фильтруются как число int
14 $id->addFilter('Int');
15
16 // Создаём переменную, которая будет хранить сообщение валидации
17 $isEmptyMessage = 'Значение является обязательным и не может быть пустым';
18
19 // Создаём элемент формы – text c именем = director
20 $director = new Zend_Form_Element_Text('director');
21
22 /*
23 * Далее пишем содержание label, который будет отображаться для данного поля,
24 * указываем, является элемент обязательным или нет,
25 * пишем список фильтров, которые будут применяться к данному элементу,
26 * и наконец, указываем валидатор и сообщение об ошибке, которое будет выведено пользователю
27 */
28 $director->setLabel('Режиссёр')
29 ->setRequired(true)
30 ->addFilter('StripTags')
31 ->addFilter('StringTrim')
32 ->addValidator('NotEmpty', true,
33 array('messages' => array('isEmpty' => $isEmptyMessage))
34 );
35
36 // Создаём второй текстовой элемент формы и проделываем те же операции
37 $title = new Zend_Form_Element_Text('title');
38 $title->setLabel('Название')
39 ->setRequired(true)
40 ->addFilter('StripTags')
41 ->addFilter('StringTrim')
42 ->addValidator('NotEmpty', true,
43 array('messages' => array('isEmpty' => $isEmptyMessage))
44 );
45
46 // Создаём элемент формы Submit c именем = submit
47 $submit = new Zend_Form_Element_Submit('submit');
48 // Создаём атрибут id = submitbutton
49 $submit->setAttrib('id', 'submitbutton');
50
51 // Добавляем все созданные элементы к форме.
52 $this->addElements(array($id, $director, $title, $submit));
53 }
54 }

Благодаря наследованию от Zend_Form у нас есть возможность создавать мощные и безопасные формы.

Zend Framework содержит классы для всех элементов форм HTML. В данном фрагменте кода мы создали 4 элемента формы. Одно скрытое, 2 текстовых поля и кнопку submit.

Теперь я бы хотел подробнее остановиться на создании одного из текстовых полей, а именно на фрагменте:

1 ->addValidator('NotEmpty', true,
2 array('messages' => array('isEmpty' => $isEmptyMessage))
3 );

Как вы уже поняли, данная запись отвечает за валидацию текстового элемента. В данном случае мы добавляем валидатор NotEmpty, который будет выводить сообщение об ошибке, если поле будет пустым. У валидатора NotEmpty есть несколько вариантов проверки: isEmpty и notEmptyInvalid. Для того чтобы просмотреть все возможные валидаторы и их опции необходимо открыть саму библиотеку Zend/Validate. В данном каталоге находятся все возможные валидаторы.

Если вы приписали одному элементу несколько валидаторов, то вам пригодится второй параметр метода addValidator. Если данный параметр равен true, то это значит, что если валидация не удалась, последующие проверки, касающиеся данного элемента проводиться не будут.

Третий параметр — это сообщения об ошибках валидации. Там мы должны указать ключ ошибки и написать сообщение. Этого можно и не делать, но тогда сообщения будут выводиться на английском языке.

Теперь, когда все подготовительные работы завершены, мы можем приступить к реализации наших action-view.

Реализация CRUD

Выводим список фильмов

Откройте контроллер IndexController, который находится в каталоге application/controllers и вставьте следующий метод:

1 public function indexAction()
2 {
3 // Создаём объект нашей модели
4 $movies = new Application_Model_DbTable_Movies();
5
6 // Применяем метод fetchAll для выборки всех записей из таблицы,
7 // и передаём их в view, через следующую запись
8 $this->view->movies = $movies->fetchAll();
9 }

В этом фрагменте мы получили все наши любимые фильмы и передали их в view, в котором будем обращаться к ним по переменной $this->movies. Откройте файл index.phtml, который находится в каталоге application\views\scripts\index и вставьте следующий код:

01 <?php
02 // Создаём заголовок страницы, который загрузится в layout
03 $this->title = "Мои любимые фильмы";
04 $this->headTitle($this->title);
05 ?>
06 <p><a href="<?php echo $this->url(array('controller'=>'index','action'=>'add'));?>">Добавить новый фильм</a></p>
07 <table>
08 <tr>
09 <th>Название</th>
10 <th>Режиссёр</th>
11 <th> </th>
12 </tr>
13 <?php
14 // Создаём patrialLoop, передав массив фильмов, полученных от контроллера
15 echo $this->partialLoop('partials/movie.phtml', $this->movies);
16 ?>
17 </table>

Т.к. использовать цикл для вывода фрагментов html кода не рекомендуется, будем использовать специальный метод partialLoop. Первый параметр — это путь к скрипту, второй массив. Создайте каталог partials в папке application\views\scripts и файл movie.phtml со следующим содержанием:

1 <tr>
2 <td><?php echo $this->escape($this->title);?></td>
3 <td><?php echo $this->escape($this->director);?></td>
4 <td>
5 <a href="<?php echo $this->url(array('controller'=>'index', 'action'=>'edit', 'id'=>$this->id));?>">Редактировать</a>
6 <a href="<?php echo $this->url(array('controller'=>'index', 'action'=>'delete', 'id'=>$this->id));?>">Удалить</a>
7 </td>
8 </tr>

В данном фрагменте используем метод escape в качестве фильтра. Теперь, если вы сделали всё правильно, то на странице www.zfdemo.web/index/index вы должны увидеть список фильмов.

Создание нового фильма

Откройте IndexController и вставьте ещё один метод:

01 public function addAction()
02 {
03 // Создаём форму
04 $form = new Application_Form_Movie();
05
06 // Указываем текст для submit
07 $form->submit->setLabel('Добавить');
08
09 // Передаём форму в view
10 $this->view->form = $form;
11
12 // Если к нам идёт Post запрос
13 if ($this->getRequest()->isPost()) {
14 // Принимаем его
15 $formData = $this->getRequest()->getPost();
16
17 // Если форма заполнена верно
18 if ($form->isValid($formData)) {
19 // Извлекаем режиссёра
20 $director = $form->getValue('director');
21
22 // Извлекаем название фильма
23 $title = $form->getValue('title');
24
25 // Создаём объект модели
26 $movies = new Application_Model_DbTable_Movies();
27
28 // Вызываем метод модели addMovie для вставки новой записи
29 $movies->addMovie($director, $title);
30
31 // Используем библиотечный helper для редиректа на action = index
32 $this->_helper->redirector('index');
33 } else {
34 // Если форма заполнена неверно,
35 // используем метод populate для заполнения всех полей
36 // той информацией, которую ввёл пользователь
37 $form->populate($formData);
38 }
39 }
40 }

Сначала мы создаём объект формы и передаём её в view. Далее следует код, который проверяет валидность заполненной формы. Если пользователь ввёл все верно, то происходит вставка в базу. Если нет, то пользователю представится возможность исправить ошибки. Откройте файл add.phtml. Добавьте следующий код:

1 <?php
2 // Создаём заголовок страницы, который загрузится в layout
3 $this->title = "Добавление любимого фильма";
4 $this->headTitle($this->title);
5
6 // Выводим форму, полученную из контроллера
7 echo $this->form ;
8 ?>

Редактирование фильма

Добавьте следующий код в IndexController:

01 public function editAction()
02 {
03 // Создаём форму
04 $form = new Application_Form_Movie();
05
06 // Указываем текст для submit
07 $form->submit->setLabel('Сохранить');
08 $this->view->form = $form;
09
10 // Если к нам идёт Post запрос
11 if ($this->getRequest()->isPost()) {
12 // Принимаем его
13 $formData = $this->getRequest()->getPost();
14
15 // Если форма заполнена верно
16 if ($form->isValid($formData)) {
17 // Извлекаем id
18 $id = (int)$form->getValue('id');
19
20 // Извлекаем режиссёра
21 $director = $form->getValue('director');
22
23 // Извлекаем название фильма
24 $title = $form->getValue('title');
25
26 // Создаём объект модели
27 $movies = new Application_Model_DbTable_Movies();
28
29 // Вызываем метод модели updateMovie для обновления новой записи
30 $movies->updateMovie($id, $director, $title);
31
32 // Используем библиотечный helper для редиректа на action = index
33 $this->_helper->redirector('index');
34 } else {
35 $form->populate($formData);
36 }
37 } else {
38 // Если мы выводим форму, то получаем id фильма, который хотим обновить
39 $id = $this->_getParam('id', 0);
40 if ($id > 0) {
41 // Создаём объект модели
42 $movies = new Application_Model_DbTable_Movies();
43
44 // Заполняем форму информацией при помощи метода populate
45 $form->populate($movies->getMovie($id));
46 }
47 }
48 }

Данный фрагмент мало отличается от предыдущего. Различия только в конце. Для того чтобы заполнить форму текстом, мы извлекаем её при помощи написанного нами метода getMovie(). Откройте файл edit.phtml и вставьте код:

1 <?php
2 // Создаём заголовок страницы, который загрузится в layout
3
4 $this->title = "Редактирование любимого фильма";
5 $this->headTitle($this->title);
6
7 // Выводим форму, полученную из контроллера
8 echo $this->form ;
9 ?>

Удаление фильма

Откройте IndexController для добавления последнего метода:

01 public function deleteAction()
02 {
03 // Если к нам идёт Post запрос
04 if ($this->getRequest()->isPost()) {
05 // Принимаем значение
06 $del = $this->getRequest()->getPost('del');
07
08 // Если пользователь подтвердил своё желание удалить запись
09 if ($del == 'Да') {
10 // Принимаем id записи, которую хотим удалить
11 $id = $this->getRequest()->getPost('id');
12
13 // Создаём объект модели
14 $movies = new Application_Model_DbTable_Movies();
15
16 // Вызываем метод модели deleteMovie для удаления записи
17 $movies->deleteMovie($id);
18 }
19
20 // Используем библиотечный helper для редиректа на action = index
21 $this->_helper->redirector('index');
22 } else {
23 // Если запрос не Post, выводим сообщение для подтверждения
24 // Получаем id записи, которую хотим удалить
25 $id = $this->_getParam('id');
26
27 // Создаём объект модели
28 $movies = new Application_Model_DbTable_Movies();
29
30 // Достаём запись и передаём в view
31 $this->view->movie = $movies->getMovie($id);
32 }
33 }

Для того чтобы поставить точку, откройте файл delete.phtml и внесите в него следующее содержание:

01 <?php
02 $this->title = "Удаление любимого фильма";
03 $this->headTitle($this->title);
04 ?>
05 <p>Вы действительно хотите удалить фильм
06 '<?php echo $this->escape($this->movie['title']); ?>' от
07 '<?php echo $this->escape($this->movie['director']); ?>'?
08 </p>
09 <form action="<?php echo $this->url(array('action'=>'delete')); ?>" method="post">
10 <div>
11 <input type="hidden" name="id" value="<?php echo $this->movie['id']; ?>" />
12 <input type="submit" name="del" value="Да" />
13 <input type="submit" name="del" value="Нет" />
14 </div>
15 </form>

В данном файле мы выводим форму, для того чтобы пользователь подтвердил своё желание удалить запись.

Заключение

В этом уроке вы познакомились с созданием layout, форм и моделей. Теперь у вас должно сложиться более ясное впечатление о том, как создавать приложения на Zend Framework. На следующей неделе я покажу вам, как создать аутентификацию средствами Zend.

На этом у меня всё, а вы помните, что…

Источник урока: www.ruseller.com
Автор: Станислав Протасевич

Отправить комментарий