Азы работы с Zend Framework (2/3) – Реализация приложения
Доброго времени суток всем гостям сайта ruseller.com. Сегодня мы продолжим наш практический экскурс в один из самых продвинутых и популярных PHP фрэймворков – Zend Framework. В сегодняшнем уроке мы реализуем простое Zend приложение, а именно: создадим layout, научимся взаимодействовать с моделями (Базами данных), формами и прочими фичами.
В первую очередь, я бы хотел напомнить вам, что мы создаём простое Zend приложение для создания картотеки наших любимых фильмов. Для того чтобы вы хорошо ориентировались в данном уроке, предлагаю вам ознакомиться с первой частью нашей серии уроков – «Азы работы с Zend Framework (1/3) - Установка и создание проекта».
Итак, на данный момент у вас должно быть создано Zend Framework приложение, состоящее из одного контроллера – Index, и четырёх action – index, add, edit, delete.
Создание базы данных и таблицы
Для того чтобы нам было с чем работать, создадим таблицу и заполним её информацией:
CREATE DATABASE `zfdemo` ;
USE `zfdemo` ;
CREATE TABLE IF NOT EXISTS `movies` (
`id` int(11) NOT NULL AUTO_INCREMENT,
`director` varchar(100) NOT NULL,
`title` varchar(100) NOT NULL,
PRIMARY KEY (`id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8 AUTO_INCREMENT=6 ;
INSERT INTO `movies` (`id`, `director`, `title`) VALUES
(1, 'Питер Джексон', 'Властелин Колец'),
(2, 'Кристофер Нолан', 'Начало'),
(3, 'Тодд Филлипс', 'Мальчишник в Вегасе'),
(4, 'Кристофер Нолан', 'Темный рыцарь'),
(5, 'Эндрю Стентон', 'ВАЛЛ-И');
Для подключения к базе данных вы обычно пользовались файлом db.php или что-то вроде этого. В Zend Framework для этих целей существует отдельный файл - application.ini, который находится в каталоге вашего проекта zfdemo\application\configs\application.ini. Перейдите в сегмент development ([development : production]) и вставьте следующий код:
resources.db.adapter = PDO_MYSQL
resources.db.params.host = localhost
resources.db.params.username = root
resources.db.params.password = sql4root
resources.db.params.dbname = zfdemo
PDO_MYSQL – это адаптер, который мы будем использовать для работы с базами данных. Если вы когда-либо работали с базами данных, то следующие параметры будут вам знакомы.
Теперь для того чтобы взаимодействовать с только что созданной таблицей, нам необходимо создать модель. Сделаем мы это при помощи Zend Tool (установка и настройка данного инструмента подробно описана в прошлой статье). Откройте консоль или командную строку. Перейдите в каталог вашего проекта (обязательно). Теперь наберите команду:
zf create db-table Movies movies
После того как вы выполните данную операцию, у вас будет создан новый каталог (application/models/DbTable) и файл Movies.php. Откройте данный файл и заполните его следующим содержимым:
<?php
class Application_Model_DbTable_Movies extends Zend_Db_Table_Abstract
{
// Имя таблицы, с которой будем работать
protected $_name = 'movies';
// Метод для получения записи по id
public function getMovie($id)
{
// Получаем id как параметр
$id = (int)$id;
// Используем метод fetchRow для получения записи из базы.
// В скобках указываем условие выборки (привычное для вас where)
$row = $this->fetchRow('id = ' . $id);
// Если результат пустой, выкидываем исключение
if(!$row) {
throw new Exception("Нет записи с id - $id");
}
// Возвращаем результат, упакованный в массив
return $row->toArray();
}
// Метод для добавление новой записи
public function addMovie($director, $title)
{
// Формируем массив вставляемых значений
$data = array(
'director' => $director,
'title' => $title,
);
// Используем метод insert для вставки записи в базу
$this->insert($data);
}
// Метод для обновления записи
public function updateMovie($id, $director, $title)
{
// Формируем массив значений
$data = array(
'director' => $director,
'title' => $title,
);
// Используем метод update для обновления записи
// В скобках указываем условие обновления (привычное для вас where)
$this->update($data, 'id = ' . (int)$id);
}
// Метод для удаления записи
public function deleteMovie($id)
{
// В скобках указываем условие удаления (привычное для вас where)
$this->delete('id = ' . (int)$id);
}
}
Мы только что создали модель с очень длинным названием 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, наберите следующую команду:
zf enable layout
После выполнения данной команды в вашем application.ini появится новая строка:
resources.layout.layoutPath = APPLICATION_PATH "/layouts/scripts/"
Ниже этой строки добавьте следующую запись, которая сообщит приложению какой использовать doctype:
resources.view.doctype = "XHTML1_STRICT"
Первая строка сообщит Zend Framework, где ему искать layout скрипт. Откройте каталог application/layouts/scripts. В данной папке вы увидите файл layout.phtml. Откройте данный файл и вставьте следующее содержание:
<?php
// Создаём meta тег Content-Type
$this->headMeta()->appendHttpEquiv('Content-Type', 'text/html;charset=utf-8');
// Указываем символ разделитель в теге title
$this->headTitle()->setSeparator(' - ');
// Определяем содержимое тега title
$this->headTitle('Уроки по Zend Framework от Ruseller.com');
// Выводим doctype, который считывается из application.ini
echo $this->doctype();
?>
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">
<head>
<?php
// Выводим meta теги
echo $this->headMeta();
?>
<?php
// Выводим заголовок сайта
echo $this->headTitle();
?>
<?php
// Прикрепляем таблицу стилей
echo $this->headLink()->prependStylesheet($this->baseUrl().'/css/site.css');
?>
</head>
<body>
<div id="content">
<h1>
<?php
// Выводим заголовок странице, который будем формировать в каждом view
echo $this->escape($this->title);
?>
</h1>
<?php
// Данная запись выводит содержимое view
echo $this->layout()->content;
?>
</div>
</body>
</html>
Теперь этот код будет вставляться на каждую страницу, которую мы будем просматривать, а вместо записи echo $this->layout()->content; будет вставляться содержимое, указанное в view (отдельно сформированное содержание каждой страницы). Теперь, когда мы захотим подключить какую-то библиотеку, таблицу стилей или скрипт, нам необходимо будет просто добавить запись в данный файл.
Для того чтобы полностью покончить с оформлением, в каталоге public создайте папку css и файл site.css:
body,html {
margin: 0 5px;
font-family: Verdana,sans-serif;
}
h1 {
font-size: 1.4em;
color: #000080;
}
a {
color: #000080;
}
/* Таблица */
th {
text-align: left;
}
td, th {
padding-right: 5px;
}
/* Форма */
form dt {
width: 100px;
display: block;
float: left;
clear: left;
}
form dd {
margin-left: 0;
float: left;
}
form #submitbutton {
margin-left: 100px;
}
Создание формы
Для того чтобы вставлять информацию в базу данных, нам необходимо создать форму, через которую пользователь будет вносить свои данные. Откройте командную строку, перейдите в каталог вашего проекта и наберите следующую команду:
zf create form Movie
После выполнения данной команды у вас создастся новый каталог forms, в котором вы найдёте файл Movie.php. Откройте данный файл и вставьте следующее содержание:
<?php
class Application_Form_Movie extends Zend_Form
{
// Метод init() вызовется по умолчанию
public function init()
{
// Задаём имя форме
$this->setName('movie');
// Создаём элемент hidden c именем = id
$id = new Zend_Form_Element_Hidden('id');
// Указываем, что данные в этом элементе фильтруются как число int
$id->addFilter('Int');
// Создаём переменную, которая будет хранить сообщение валидации
$isEmptyMessage = 'Значение является обязательным и не может быть пустым';
// Создаём элемент формы – text c именем = director
$director = new Zend_Form_Element_Text('director');
/*
* Далее пишем содержание label, который будет отображаться для данного поля,
* указываем, является элемент обязательным или нет,
* пишем список фильтров, которые будут применяться к данному элементу,
* и наконец, указываем валидатор и сообщение об ошибке, которое будет выведено пользователю
*/
$director->setLabel('Режиссёр')
->setRequired(true)
->addFilter('StripTags')
->addFilter('StringTrim')
->addValidator('NotEmpty', true,
array('messages' => array('isEmpty' => $isEmptyMessage))
);
// Создаём второй текстовой элемент формы и проделываем те же операции
$title = new Zend_Form_Element_Text('title');
$title->setLabel('Название')
->setRequired(true)
->addFilter('StripTags')
->addFilter('StringTrim')
->addValidator('NotEmpty', true,
array('messages' => array('isEmpty' => $isEmptyMessage))
);
// Создаём элемент формы Submit c именем = submit
$submit = new Zend_Form_Element_Submit('submit');
// Создаём атрибут id = submitbutton
$submit->setAttrib('id', 'submitbutton');
// Добавляем все созданные элементы к форме.
$this->addElements(array($id, $director, $title, $submit));
}
}
Благодаря наследованию от Zend_Form у нас есть возможность создавать мощные и безопасные формы.
Zend Framework содержит классы для всех элементов форм HTML. В данном фрагменте кода мы создали 4 элемента формы. Одно скрытое, 2 текстовых поля и кнопку submit.
Теперь я бы хотел подробнее остановиться на создании одного из текстовых полей, а именно на фрагменте:
->addValidator('NotEmpty', true,
array('messages' => array('isEmpty' => $isEmptyMessage))
);
Как вы уже поняли, данная запись отвечает за валидацию текстового элемента. В данном случае мы добавляем валидатор NotEmpty, который будет выводить сообщение об ошибке, если поле будет пустым. У валидатора NotEmpty есть несколько вариантов проверки: isEmpty и notEmptyInvalid. Для того чтобы просмотреть все возможные валидаторы и их опции необходимо открыть саму библиотеку Zend/Validate. В данном каталоге находятся все возможные валидаторы.
Если вы приписали одному элементу несколько валидаторов, то вам пригодится второй параметр метода addValidator. Если данный параметр равен true, то это значит, что если валидация не удалась, последующие проверки, касающиеся данного элемента проводиться не будут.
Третий параметр - это сообщения об ошибках валидации. Там мы должны указать ключ ошибки и написать сообщение. Этого можно и не делать, но тогда сообщения будут выводиться на английском языке.
Теперь, когда все подготовительные работы завершены, мы можем приступить к реализации наших action-view.
Реализация CRUD
Выводим список фильмов
Откройте контроллер IndexController, который находится в каталоге application/controllers и вставьте следующий метод:
public function indexAction()
{
// Создаём объект нашей модели
$movies = new Application_Model_DbTable_Movies();
// Применяем метод fetchAll для выборки всех записей из таблицы,
// и передаём их в view, через следующую запись
$this->view->movies = $movies->fetchAll();
}
В этом фрагменте мы получили все наши любимые фильмы и передали их в view, в котором будем обращаться к ним по переменной $this->movies. Откройте файл index.phtml, который находится в каталоге application\views\scripts\index и вставьте следующий код:
<?php
// Создаём заголовок страницы, который загрузится в layout
$this->title = "Мои любимые фильмы";
$this->headTitle($this->title);
?>
<p><a href="<?php echo $this->url(array('controller'=>'index','action'=>'add'));?>">Добавить новый фильм</a></p>
<table>
<tr>
<th>Название</th>
<th>Режиссёр</th>
<th> </th>
</tr>
<?php
// Создаём patrialLoop, передав массив фильмов, полученных от контроллера
echo $this->partialLoop('partials/movie.phtml', $this->movies);
?>
</table>
Т.к. использовать цикл для вывода фрагментов html кода не рекомендуется, будем использовать специальный метод partialLoop. Первый параметр - это путь к скрипту, второй массив. Создайте каталог partials в папке application\views\scripts и файл movie.phtml со следующим содержанием:
<tr>
<td><?php echo $this->escape($this->title);?></td>
<td><?php echo $this->escape($this->director);?></td>
<td>
<a href="<?php echo $this->url(array('controller'=>'index', 'action'=>'edit', 'id'=>$this->id));?>">Редактировать</a>
<a href="<?php echo $this->url(array('controller'=>'index', 'action'=>'delete', 'id'=>$this->id));?>">Удалить</a>
</td>
</tr>
В данном фрагменте используем метод escape в качестве фильтра. Теперь, если вы сделали всё правильно, то на странице www.zfdemo.web/index/index вы должны увидеть список фильмов.
Создание нового фильма
Откройте IndexController и вставьте ещё один метод:
public function addAction()
{
// Создаём форму
$form = new Application_Form_Movie();
// Указываем текст для submit
$form->submit->setLabel('Добавить');
// Передаём форму в view
$this->view->form = $form;
// Если к нам идёт Post запрос
if ($this->getRequest()->isPost()) {
// Принимаем его
$formData = $this->getRequest()->getPost();
// Если форма заполнена верно
if ($form->isValid($formData)) {
// Извлекаем режиссёра
$director = $form->getValue('director');
// Извлекаем название фильма
$title = $form->getValue('title');
// Создаём объект модели
$movies = new Application_Model_DbTable_Movies();
// Вызываем метод модели addMovie для вставки новой записи
$movies->addMovie($director, $title);
// Используем библиотечный helper для редиректа на action = index
$this->_helper->redirector('index');
} else {
// Если форма заполнена неверно,
// используем метод populate для заполнения всех полей
// той информацией, которую ввёл пользователь
$form->populate($formData);
}
}
}
Сначала мы создаём объект формы и передаём её в view. Далее следует код, который проверяет валидность заполненной формы. Если пользователь ввёл все верно, то происходит вставка в базу. Если нет, то пользователю представится возможность исправить ошибки. Откройте файл add.phtml. Добавьте следующий код:
<?php
// Создаём заголовок страницы, который загрузится в layout
$this->title = "Добавление любимого фильма";
$this->headTitle($this->title);
// Выводим форму, полученную из контроллера
echo $this->form ;
?>
Редактирование фильма
Добавьте следующий код в IndexController:
public function editAction()
{
// Создаём форму
$form = new Application_Form_Movie();
// Указываем текст для submit
$form->submit->setLabel('Сохранить');
$this->view->form = $form;
// Если к нам идёт Post запрос
if ($this->getRequest()->isPost()) {
// Принимаем его
$formData = $this->getRequest()->getPost();
// Если форма заполнена верно
if ($form->isValid($formData)) {
// Извлекаем id
$id = (int)$form->getValue('id');
// Извлекаем режиссёра
$director = $form->getValue('director');
// Извлекаем название фильма
$title = $form->getValue('title');
// Создаём объект модели
$movies = new Application_Model_DbTable_Movies();
// Вызываем метод модели updateMovie для обновления новой записи
$movies->updateMovie($id, $director, $title);
// Используем библиотечный helper для редиректа на action = index
$this->_helper->redirector('index');
} else {
$form->populate($formData);
}
} else {
// Если мы выводим форму, то получаем id фильма, который хотим обновить
$id = $this->_getParam('id', 0);
if ($id > 0) {
// Создаём объект модели
$movies = new Application_Model_DbTable_Movies();
// Заполняем форму информацией при помощи метода populate
$form->populate($movies->getMovie($id));
}
}
}
Данный фрагмент мало отличается от предыдущего. Различия только в конце. Для того чтобы заполнить форму текстом, мы извлекаем её при помощи написанного нами метода getMovie(). Откройте файл edit.phtml и вставьте код:
<?php
// Создаём заголовок страницы, который загрузится в layout
$this->title = "Редактирование любимого фильма";
$this->headTitle($this->title);
// Выводим форму, полученную из контроллера
echo $this->form ;
?>
Удаление фильма
Откройте IndexController для добавления последнего метода:
public function deleteAction()
{
// Если к нам идёт Post запрос
if ($this->getRequest()->isPost()) {
// Принимаем значение
$del = $this->getRequest()->getPost('del');
// Если пользователь подтвердил своё желание удалить запись
if ($del == 'Да') {
// Принимаем id записи, которую хотим удалить
$id = $this->getRequest()->getPost('id');
// Создаём объект модели
$movies = new Application_Model_DbTable_Movies();
// Вызываем метод модели deleteMovie для удаления записи
$movies->deleteMovie($id);
}
// Используем библиотечный helper для редиректа на action = index
$this->_helper->redirector('index');
} else {
// Если запрос не Post, выводим сообщение для подтверждения
// Получаем id записи, которую хотим удалить
$id = $this->_getParam('id');
// Создаём объект модели
$movies = new Application_Model_DbTable_Movies();
// Достаём запись и передаём в view
$this->view->movie = $movies->getMovie($id);
}
}
Для того чтобы поставить точку, откройте файл delete.phtml и внесите в него следующее содержание:
<?php
$this->title = "Удаление любимого фильма";
$this->headTitle($this->title);
?>
<p>Вы действительно хотите удалить фильм
'<?php echo $this->escape($this->movie['title']); ?>' от
'<?php echo $this->escape($this->movie['director']); ?>'?
</p>
<form action="<?php echo $this->url(array('action'=>'delete')); ?>" method="post">
<div>
<input type="hidden" name="id" value="<?php echo $this->movie['id']; ?>" />
<input type="submit" name="del" value="Да" />
<input type="submit" name="del" value="Нет" />
</div>
</form>
В данном файле мы выводим форму, для того чтобы пользователь подтвердил своё желание удалить запись.
Заключение
В этом уроке вы познакомились с созданием layout, форм и моделей. Теперь у вас должно сложиться более ясное впечатление о том, как создавать приложения на Zend Framework. На следующей неделе я покажу вам, как создать аутентификацию средствами Zend.
На этом у меня всё, а вы помните, что…