Programmer's Reference Guide

Zend_View

Zend_View
Guide de référence du programmeur

Introduction

Zend_View est une classe qui permet de travailler avec la partie "vue" du design pattern Modèle Vue Contrôleur. Elle existe pour aider à garder la vue séparée du modèle et des scripts du contrôleur. Elle fournie un système d'aide, de filtres d'affichage, et d'échappement de variables.

Zend_View est un système de template agnostique; vous pouvez utiliser PHP comme langage de template, ou créer des instances d'autres systèmes de templates, et les manipuler à travers les scripts de vue.

L'utilisation de Zend_View se déroule en étape principales : 1. Votre script de contrôleur crée une instance de Zend_View et assigne des variables à cette instance. 2. Le contrôleur dit à Zend_View de rendre une vue particulière, et de ce fait va donner le contrôle au script de vue, qui va générer l'affichage.

Script du Contrôleur

Comme exemple simple, imaginons que vous contrôleur aie une liste de données sur des livres qu'il veut rendre en passant par une vue. Le contrôleur pourrait alors ressembler à ceci :

<?php
// utilise un modèle pour obtenir les données sur les livres : auteurs et titres
$data = array(
    array(
        'auteur' => 'Hernando de Soto',
        'titre' => 'Le mystère du capitalisme'
    ),
    array(
        'auteur' => 'Henry Hazlitt',
        'titre' => 'Les sciences économique en un cours'
    ),
    array(
        'auteur' => 'Milton Friedman',
        'titre' => 'Libre de choisir'
    )
);

// assigniation des données du livre à une instance Zend_View
Zend_Loader::loadClass('Zend_View');
$view = new Zend_View();
$view->books = $data;

// et appel du script de rendu d'affichage appelé &quot;booklist.php&quot;
echo $view->render('booklist.php');

Script de vue

Maintenant, nous avons besoin d'associer le script de vue, "booklist.php". C'est un script PHP comme les autres, à une exception près : il s'exécute dans la portée de l'instance Zend_View, ce qui veut dire que les référence à $this pointent vers les attributs et les méthodes de Zend_View. (Les variables assignées à l'instance par le contrôleur sont des propriétés publiques de l'instance Zend_View). Ainsi un script de vue de base pourrait ressembler à ceci:

<?php if ($this->books): ?>

    <!-- La table des livres -->
    <table>
        <tr>
            <th>Auteur</th>
            <th>Titre</th>
        </tr>

        <?php foreach ($this->books as $key => $val): ?>
        <tr>
            <td><?php echo $this->escape($val['auteur']) ?></td>
            <td><?php echo $this->escape($val['titre']) ?></td>
        </tr>
        <?php endforeach; ?>

    </table>

<?php else: ?>

    <p>Aucun livre à afficher</p>

<?php endif; ?>

Notez l'utilisation de la méthode escape pour échapper les variables à afficher.

Options

Zend_View has several options that may be set to configure the behaviour of your view scripts.

basePath: indicate a base path from which to set the script, helper, and filter path. It assumes a directory structure of:
```
base/path/
    helpers/
    filters/
    scripts/
			    
```
This may be set via setBasePath(), addBasePath(), or the basePath option to the constructor.
encoding: indicate the character encoding to use with htmlentities(), htmlspecialchars(), and other operations. Defaults to ISO-8859-1 (latin1). May be set via setEncoding() or the encoding option to the constructor.
escape: indicate a callback to be used by escape(). May be set via setEscape() or the escape option to the constructor.
filter: indicate a filter to use after rendering a view script. May be set via setFilter(), addFilter(), or the filter option to the constructor.
strictVars: force Zend_View to emit notices and warnings when uninitialized view variables are accessed. This may be set by calling strictVars(true) or passing the strictVars option to the constructor.

Utility Accessors

Typically, you'll only ever need to call on assign(), render(), or one of the methods for setting/adding filter, helper, and script paths. However, if you wish to extend Zend_View yourself, or need access to some of its internals, a number of accessors exist:

getVars() will return all assigned variables.
clearVars() will clear all assigned variables; useful when you wish to re-use a view object, but want to control what variables are available..
getScriptPath($script) will retrieve the resolved path to a given view script.
getScriptPaths() will retrieve all registered script paths.
getHelperPath($helper) will retrieve the resolved path to the named helper class.
getHelperPaths() will retrieve all registered helper paths.
getFilterPath($filter) will retrieve the resolved path to the named filter class.
getFilterPaths() will retrieve all registered filter paths.