Zend Framework по-русски

Приветствую вас.
Это вторая статья серии, посвящённой основам Zend Framework.
Первая статья серии
В этой статье вы более подробно ознакомитесь с Zend_Controller и научитесь использовать Zend_Controller_Router_Rewrite.

Часть 3. Подробнее о Zend_Controller

1
2
3
4
5
6
7
8
9
10
11
12
//начальное объявление констант

//позволяет добиться гибкости именования и размещения основных каталогов

define('ROOTPATH', $_SERVER['DOCUMENT_ROOT'] . '/..');

define('HOMEPATH', ROOTPATH . '/public_html');

define('LIBPATH', ROOTPATH . '/lib');



//устанавливаем каталог библиотек корневым и подключаем Zend_Controller

set_include_path(LIBPATH . '/library');

require_once('Zend/Controller/Front.php');



//собственно, запуск выполнения нужного действия (action)

Zend_Controller_Front::run(LIBPATH . '/application/controllers');

Как вы видите, запускает Zend_Controller единственный метод – run, которому мы передаём путь до каталога контроллеров. Довольно просто и удобно, но этим возможности Zend_Controller_Front не ограничиваются. Мы можем явно инстанцировать Zend_Controller_Front и управлять им при помощи публичных методов и расширять его возможности плагинами и обработчиками. Одним словом, настраиваемость Zend_Controller поражает воображение
Zend_Controller_Front реализует паттерн проектирования Одиночка (Singleton), о чём мы поговорим позже. Сейчас нам важно одно – инстанцирование класса при помощи оператора “new” невозможно. Единственный способ получить экземпляр этого класса – вызвать статический метод Zend_Controller_Front::getInstance(). Если вы не знаете, что делает паттерн Singleton – полезно будет ознакомиться с этим, благо в интернете множество материала на эту тему.
Вот пример расширенного использования Zend_Controller_Front:

1
2
3
$front = Zend_Controller_Front::getInstance();

$front->setControllerDirectory(LIBPATH . '/application/controllers');

$front->dispatch();

Ничем особенным этот код от вызова метода Zend_Controller_Front::run() не отличается, но даёт нам простор для настройки.
Есть ещё один полезный инструмент Zend_Controller_Front: параметры. Управление параметрами происходит при помощи следующих методов:

• setParam($name, $value) – устанавливает параметру $name значение $value
• setParams(array $params) – устанавливает параметры с помощью ассоциативного массива
• getParam($name) – получаем значение параметра
• getParams() – получаем ассоциативный массив со всеми параметрами
• clearParams($name = null) – удаляем один параметр (если имя параметра не передано – удаляем все параметры)

Что же такое особенное нам позволяют сделать параметры? В Zend_Controller встроено несколько параметров

• useDefaultControllerAlways – для всех URL, контроллер и/или действие для которых не найдены, используется контроллер по умолчанию (IndexController)
• disableOutbutBuffering – отключает встроенную буферизацию вывода (по умолчанию включена)
• noViewRenderer – отключает помощник ViewRenderer (по умолчанию включен)
• noErrorHandler – отключает плагин ErrorHandler (по умолчанию включен)

О последних двух параметрах (ViewRenderer и ErrorHandler) я расскажу вам несколько позже.
Расширим наш код отключением помощника ViewRenderer:

1
2
3
4
$front = Zend_Controller_Front::getInstance();

$front->setControllerDirectory(LIBPATH . '/application/controllers');

$front->setParam('noViewRenderer', true);

$front->dispatch();

Часть 4. Zend_Controller_Router_Rewrite

Router_Rewrite – используемый по умолчанию маршрутизатор Zend_Controller. По сути, маршрутизатор разбивает URL на части и определяет, какой контроллер и какое действие в нём заданы.
Для того, чтобы сработал Router_Rewrite, необходимо создать в каталоге с index.php файл .htaccess с текстом:

1
2
RewriteEngine on

RewriteRule !\.(js|ico|gif|jpg|png|css)$ index.php

Указанное нами правило mod_rewrite будет переадресовывать все запросы, не содержащие перечисленные расширения, файлу index.php. Это позволит классу Zend_Controller_Router_Rewrite отловить и обработать эти запросы.
Добавим новый маршрут:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
$front = Zend_Controller_Front::getInstance();

$front->setControllerDirectory(LIBPATH . '/application/controllers');

$router = $front->getRouter();

$router->addRoute(

    'user',

    new Zend_Controller_Router_Route(

        'user/:username',   //указываем URL

        array(

            'controller' => 'users',    //имя контроллера

            'action' => 'info',     //имя действия

            'username' => 'admin'   //значение по умолчанию

        )

    )

);

$front->dispatch();

Теперь при наборе URL http://site.ru/user/artemon выполнится контроллер Users, действие info. Если username не будет указан в URL, то ему присвоится значение по умолчанию ‘admin’ (см. предыдущий пример). Получить username мы сможем в нашем действии (infoAction), вызвав метод _getParam():

1
echo $this->_getParam('username');

Вот и всё. Основы Zend_Controller раскрыты, я надеюсь, достаточно для начала работы. Как я уже говорил, ничто не заменит вам документацию и API Zend Framework.
До скорых встреч!