Objet de réponseUtilisationL'objet de réponse équilibre la balance du modèle MVC avec l'objet de requête. Son but est de collecter du contenu et des en-têtes, afin d'être rendue. De plus, le contrôleur frontal passe les exceptions qu'il a rencontré à l'objet de réponse, vous offrant une possibilité élégante de les gérer. Ce comportement peut être changé avec Zend_Controller_Front::throwExceptions(true) : Pour rendre toute la réponse : corps et en-têtes, utilisez sendResponse().
Vous ne devriez pas afficher du contenu directement dans un contrôleur. Empiler plutôt les affichages dans l'objet de réponse :
Grâce à cela, tous les en-têtes sont envoyés d'un coup, juste avant l'affichage du contenu.
Si une exception est ajoutée par le contrôleur frontal à la réponse, utilisez isException() pour vérifier ceci, et récupérez les exceptions avec getException(). Vous pourriez par exemple créer un objet de réponse d'erreur, comme un 404, et journaliser l'exception, etc. Pour prendre la main sur l'objet de réponse, demandez le au contrôleur frontal via un accesseur, ou commandez lui de vous retourner la celle-ci lors après la distribution.
Par défaut, les messages d'exceptions ne sont pas affichés. Utilisez renderExceptions() si vous le voulez. Aussi, vous pouvez activer leur rendu grâce à Zend_Controller_Front::throwExceptions() :
Manipulation des en-têtesComme nous l'avons vu, un des rôles de l'objet de réponse est de gérer les en-têtes HTTP. Une variété de méthodes permet de contrôler cette gestion :
De plus, des accesseurs spéciaux sont disponibles pour manipuler le code de réponse HTTP : setHttpResponseCode() et getHttpResponseCode(). Segments nommésL'objet de réponse propose une fragmentation par segments. Ceci permet de séparer le corps de la réponse dans plusieurs segments réceptacles, que vous pouvez afficher dans un ordre précis. En interne, il s'agit d'un tableau namespacé qui dispose de méthodes de manipulation. Par exemple, vous pourriez utiliser l'évènement preDispatch() pour rajouter un bandeau de header au corps de la réponse, et l'évènement postDispatch() pour en ajouter un bandeau de footer :
Un appel à
Lorsque ceci est rendu, ça l'est dans l'ordre dans lequel les segments sont rangés dans la réponse. Voici quelques méthodes permettant de manipuler les segments de la réponse :
Manipulation des exceptions dans l'objet de réponseComme déjà mentionné, par défaut, les exceptions rencontrées durant le processus MVC de distribution, sont ajoutées à l'objet de réponse. Elles le sont dans une pile, ce qui vous permet de toutes les garder -- les exceptions d'application, les exceptions de distribution, les exceptions de plugin -- etc... Si vous voulez manipuler finement celles-ci, voyez plutôt les méthodes ci-après :
Dériver l'objet de réponseL'objet de réponse sert à collecter les en-têtes HTTP de la réponse, ainsi que son contenu, depuis le système MVC mais aussi de l'afficher au client. De plus, l'objet collecte les exceptions et permet de les gérer, de les retourner, ou de les garder sous silence. La classe de base est Zend_Controller_Response_Abstract, et toute dérivation devra en hériter directement ou indirectement. Les méthodes qu'elle propose ont été vues dans les sections précédentes. Vous pouvez dériver l'objet de réponse pour plusieurs raisons, incluant la volonté de modifier le retour de la sortie, pour ne pas envoyer d'en-têtes dans un environnement de requête CLI ou PHP-GTK, la gestion de templates, etc.
|
|