PHP5

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

$front->throwExceptions(true);
        

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

$response->sendResponse();
        

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

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

Этим достигается то, что все заголовки будут отправлены одновременно, непосредственно до того, как будет отображено содержимое ответа.

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

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

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

// Либо метод 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();
        

Как было замечено ранее, одной из обязанностей объекта ответа является сбор и отправка заголовков ответа HTTP. Для этого есть различные методы:

Кроме перечисленных выше методов, есть аксессоры для установки и получения кода ответа для текущего запроса, setHttpResponseCode() и getHttpResponseCode().

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

Например, вы можете использовать перехватчик preDispatch() для добавления верха страницы в объект ответа, затем метод действия должен добавить тело страницы, а перехватчик postDispatch() добавляет низ страницы:

<?php
// Предполагается, что класс плагина зарегистрирован во фронт-контроллере class MyPlugin extends Zend_Controller_Plugin_Abstract
{
    public function preDispatch(Zend_Controller_Request_Abstract $request)
    {
        $response = $this->getResponse();
        $view = new Zend_View();
        $view->setBasePath('../views/scripts');

        $response->prepend('header', $view->render('header.phtml'));
    }

    public function postDispatch(Zend_Controller_Request_Abstract $request)
    {
        $response = $this->getResponse();
        $view = new Zend_View();
        $view->setBasePath('../views/scripts');

        $response->append('footer', $view->render('footer.phtml'));
    }
}

// Пример контроллера действий class MyController extends Zend_Controller_Action
{
    public function fooAction()
    {
        $this->render();
    }
}
        

В примере выше вызов /my/foo приведет к тому, что конечное содержимое тела объекта ответа будет иметь следующую структуру:

<?php
array(
    'header'  => ..., // содержимое верха страницы
    'default' => ..., // содержимое тела страницы из MyController::fooAction()
    'footer'  => ...  // содержимое низа страницы
);
        

Рендеринг производится в том порядке, в котором элементы представлены в массиве.

Для управления именованными сегментами могут использоваться различные методы:

Как было отмечено ранее, по умолчанию исключения, пойманные во время диспетчеризации, регистрируются в объекте ответа. Исключения регистрируются в стеке, что позволяет вам хранить все брошенные исключения - исключения приложения, диспетчера, плагинов и т.д. Если нужно производить проверку на определенные исключения или журналировать их, то используйте следующее API объекта ответа для исключений:

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

Базовым классом ответа является Zend_Controller_Response_Abstract, все создаваемые вами подклассы должны наследовать от него или одного из его потомков. Доступные методы были перечислены в предыдущих разделах.

Цели, преследуемые при создании подклассов объекта ответа, включают в себя изменение способа вывода, основанное на окружении запроса (например, не отправлять заголовки для запросов CLI или PHP-GTK), добавление функционала для возвращения конечного вида, основанного на содержимом, сохраненном в именованном сегменте, и т.д.