Zend_Controller предоставляет основу для построения веб-сайта, базирующегося на паттерне Model-View-Controller (MVC).

Система Zend_Controller задумана как легковесная, модульная и расширяемая. Ее архитектура в минималистском стиле обеспечивает гибкость и некоторую свободу пользователям и в то же время предоставляет достаточно структуры, чтобы системы, построенные с использованием Zend_Controller разделяли некоторые общие соглашения и имели сходный код.

Рабочий процесс Zend_Controller осуществляется несколькими компонентами. Несмотря на то, что для использования этой системы нет необходимости в совершенном понимании внутренней работы всех компонент, полезно иметь практические знания данного процесса.

Рабочий процесс Zend_Controller относительно простой. Запрос получается объектом Zend_Controller_Front, который по очереди вызывает Zend_Controller_Router_Rewrite для определения того, какой контроллер (и какое действие в этом контроллере) следует использовать. Zend_Controller_Router_Rewrite анализирует URI для установки имен контроллера и действия в запросе. Затем Zend_Controller_Front входит в цикл диспетчеризации. Он вызывает Zend_Controller_Dispatcher_Standard и передает ему запрос для запуска контроллера и действия, определенных в запросе (или тех, которые используются по умолчанию). После того, как контроллер завершит работу, управление возвращается Zend_Controller_Front. Если предыдущий контроллер посредством переустановки статуса диспетчеризации в запросе указал, что должен быть запущен другой контроллер, то цикл продолжается и выполняется запуск другого контроллера. В противном случае процесс завершается.

Объект запроса является простым объектом значений, который передается между Zend_Controller_Front, роутером, диспетчером и контроллерами. Он включает в себя определение контроллера, действия и параметров, которые нужно передать действию, а также остальные переменные запроса, будь это HTTP, CLI или PHP-GTK.

Методов может быть больше, в зависимости от типа запроса. Например, используемый по умолчанию запрос Zend_Controller_Request_Http имеет методы для получения URI запроса, пути, параметры $_GET и $_POST и т.д.

Объект запроса передается Zend_Controller_Front либо, если ничего не было передано, инициализируется в начале процесса диспетчеризации до того, как будет запущен прощесс маршрутизации. Он передается каждому объекту в цепочке диспетчеризации.

Кроме этого, объект запроса особенно полезен в тестировании. Разработчики могут имитировать переменные запроса, включая в объект запроса контроллер, действие, параметры, URI и т.д., и затем передавая его фронт-контроллеру для проверки работы приложения. Если комбинируется с объектом ответа, становится возможным тщательное и точное юнит-тестирование приложений на основе MVC.

Перед тем, как начать писать свой первый контроллер, надо сначала понять, как работает процесс маршрутизации, и как это реализовано в Zend_Controller_Router_Rewrite. Помните, что рабочий процесс делится на маршрутизацию, которая выполняется только один раз, и диспетчеризацию, которая выполняется циклически после маршрутизации.

Zend_Controller_Front вызывает Zend_Controller_Router_Rewrite (или другой установленный маршрутизатор) для определения того, какой контроллер (и какое действие внутри этого контроллера) соответствует данному URI. Zend_Controller_Router извлекает URI из объекта запроса и передает его объектам маршрута в своей цепочке; по умолчанию он использует Zend_Controller_Router_Route_Module для сопоставления с приходящими URL-ами. Объект маршрута разбирает URL для определения контроллера, действия и других параметров URL, переданных в пути, и устанавливает их в объекте запроса.

Zend_Controller_Router_Route_Module использует очень простую схему определения имени контроллера и имени действия в этом контроллере:

http://framework.zend.com/controller/action/
        

Обратите внимание, что первый сегмент всегда является именем контроллера, а второй сегмент — именем действия.

В URI могут быть определены параметры, которые будут переданы контроллеру. Они имеют вид пар ключ/значение:

http://framework.zend.com/controller/action/key1/value1/
        

Если в пути URI отсутствуют контроллер и действие, то Zend_Controller_Dispatcher_Standard попытается получить значения из параметров объекта запроса и, если ничего не найдено, использовать значения по умолчанию. В обоих случаях значениями по умолчанию будет "index". Следующие примеры иллюстрируют это:

http://framework.zend.com/roadmap/future/
Controller: roadmap
Action    : future

http://framework.zend.com/roadmap/
Controller: roadmap
Action    : index

http://framework.zend.com/
Controller: index
Action    : index
        

Кроме этого, вы можете определять контроллеры в поддиректориях или модулях следующими способами:

Имя контроллера, имя действия в этом контроллере и любые необязательные параметры (включая модуль) устанавливаются в объекте запроса. Когда Zend_Controller_Front входит в цикл диспетчеризации, объект запроса передается Zend_Controller_Dispatcher_Standard.

Диспетчеризация — это процесс принятия объекта запроса (Zend_Controller_Request_Abstract), извлечения содержащихся в нем имени контроллера, имени действия и необязательных параметров, и затем инстанцирования контроллера, вызова действия в нем. Если не найдены контроллер и действие, то будут использоваться значения, принятые для них по умолчанию. Для обоих Zend_Controller_Dispatcher_Standard использует index как значение по умолчанию, но позволяет изменять значения по умолчанию через методы setDefaultController() и setDefaultAction().

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

В начале каждой итерации цикла он устанавливает флаг в объекте запроса, означающий, что действие было запущено. Если действие или методы pre/postDispatch установленного плагина сбросят этот флаг, то цикл диспетчеризации продолжится и попытается обработать запрос снова. Изменяя контроллер и/или действие в запросе и сбрасывая флаг диспетчеризации, разработчик может определять цепочку запросов для обработки.

Метод действия контроллера, который таким образом управляет диспетчеризацией, называется _forward(); вызывайте этот метод из любого метода pre/postDispatch() или действия, указывая контроллер, действие и необязательные параметры, которые вы, возможно, захотите передать новому действию.

public function myAction()
{
    // выполнение каких-либо действий...
    // передача управления другому действию FooController::barAction()
    // в текущем модуле
    $this->_forward('bar', 'foo', null, array('baz' => 'bogus'));
}

Объект ответа составляет логичную пару объекту запроса. Его назначение — сбор контента и/или заголовков, таким образом они могут возвращаться вместе. Кроме этого, фронт-контроллер будет передавать любые пойманные исключения объекту ответа, давая разработчику возможность должным образом обрабатывать исключения. Эта возможность может быть отключена установкой Zend_Controller_Front::throwExceptions(true):

$front->throwExceptions(true);

Для отправки выходных данных ответа, включая заголовки, используйте метод sendOutput().

$response->sendOutput();

Разработчики должны использовать объекты ответа в своих контроллерах. Вместо непосредственного вывода и отправки заголовков, следует помещать их в объект запроса:

// В действии контроллера:
// Установка заголовка
$this->getResponse()
    ->setHeader('Content-Type', 'text/html')
    ->appendBody($content);

Посредством таких операций вы добьетесь того, что все заголовки будут выведены одновременно до того, как будет выведено содержимое.

Для проверки того, произошло ли исключение в приложении, проверяйте флаг isException() в объекте ответа и извлекайте объект исключения, используя метод getException(). Кроме этого, можно создавать объекты ответа, которые перенаправляют на страницы сообщений об ошибке, журналируют сообщения исключения, обеспечивают привлекательный формат сообщений исключения (для среды разработки) и т.п.

Вы можете получить объект ответа после вызова метода dispatch() фронт-контроллера или указать фронт-контроллеру, чтобы он возвращал объект ответа вместо его вывода.

// получение объекта ответа после диспетчеризации
$front->dispatch();
$response = $front->getResponse();
if ($response->isException()) {
    // log, mail, etc...
}

// или dispatch() возвращает объект ответа 
$front->returnResponse(true);
$response = $front->dispatch();

// делаем что-либо...

// вывод ответа
$response->sendResponse();

По умолчанию сообщения исключений не отображаются. Это поведение может быть переопределено вызовом метода renderExceptions() или включением возможности генерации исключений throwExceptions() фронт-контроллером, как показано ниже:

$response->renderExceptions(true);
$front->dispatch($request, $response);

// или:
$front->returnResponse(true);
$response = $front->dispatch();
$response->renderExceptions();
$response->sendResponse();

// или:
$front->throwExceptions(true);
$front->dispatch();