Programmer's Reference Guide
| Zend_Layout options de configuration |
Zend_Layout, utilisation avancée
Zend_Layout permet d'être utilisé de manière plus pointu.
Vous pouvez agir sur ces éléments :
Objet de vue personnalisé.
Zend_Layoutaccepte tout objet de vue implémentant l'interfaceZend_View_Interface.Plugin contrôleur frontal personnalisé.
Zend_Layoutest livré avec un plugin qui rend le layout automatiquement avant de renvoyer la réponse (utilisation MVC). Vous pouvez injecter votre propre plugin.Aide d'action personnalisée.
Zend_Layoutest livrée avec une aide d'action qui devrait en théorie suffire dans la majorité des cas. C'est un proxy vers l'objetZend_Layout. Vous pouvez cependant utiliser votre propre classe d'aide.Résolveur de chemin de script personnalisé.
Zend_Layoutvous permet d'utiliser votre inflecteur pour la résolution des scripts de layout ou de modifier l'inflecteur par défaut.
Objets de vue personnalisés
Zend_Layout accepte des objets de vue implémentant
Zend_View_Interface ou étendant
Zend_View_Abstract pour le rendu du script de layout.
Passez le en paramètre au constructeur ou à startMvc(),
ou utilisez l'accesseur setView() :
<?php $view = new My_Custom_View(); $layout->setView($view); ?>
Note: Attention à vos implémentations de Zend_View
Même siZend_Layoutvous permet d'utiliser votre propre objet de vue (implémentantZend_View_Interface), vous pouvez rencontrer des problèmes si votre vue n'a pas accès à certaines aides de vue, en particulier les aides "layout" et "placeholder".Zend_Layouteffectue des affectations de variables sur la vue via ces aides.
Si vous avez besoin d'un objetZend_Viewpersonnalisé qui ne supporte pas ces aides de vue, vous devrez alors trouver un moyen de passer les variables du layout à la vue. Par exemple, en étendant l'objetZend_Layoutet en rédéfinissant la méthoderender()en passant des variables à la vue. Aussi, vous pouvez créer votre propre plugin qui s'occupe de passer ces variables avant le rendu du layout.
De même, si votre implémentation de la vue permet l'extension via des plugins, vous pouvez à tout moment accéder aux variables du layout grâce à l'aide placeholder en utilisant la clé "Zend_Layout" :
<?php $placeholders = new Zend_View_Helper_Placeholder(); $layoutVars = $placeholders->placeholder('Zend_Layout')->getArrayCopy(); ?>
Plugin de contrôleur frontal personnalisé
Lorsqu'utilisé avec les composants MVC, Zend_Layout
enregistre un plugin de contrôleur frontal qui se charge du rendu du
layout juste avant la fin de la boucle de dispatching. Ceci convient à la
majorité des cas, si cependant vous avez besoin de construire votre propre
plugin, passez son nom dans l'option pluginClass de la méthode
startMvc().
Votre plugin doit alors étendre Zend_Controller_Plugin_Abstract,
et devrait accepter un objet Zend_Layout lors de sa construction.
La classe par défaut du plugin est
Zend_Layout_Controller_Plugin_Layout.
Aide d'action personnalisée
Si les composants MVC sont utilisés, alors Zend_Layout
enregistre une classe d'aide d'action dans le gestionnaire d'aides
(helper broker). Par défaut, il s'agit de
Zend_Layout_Controller_Action_Helper_Layout. Cette aide
agit comme un proxy vers l'instance de Zend_Layout et
permet d'y accéder dans vos actions.
Si vous voulez utiliser votre propre classe, celle-ci devra alors
étendre Zend_Controller_Action_Helper_Abstract. Passez le
nom de la classe dans l'option helperClass de la méthode
startMvc().
Résolution de chemin de script personnalisé (inflecteur)
Zend_Layout utilise Zend_Filter_Inflector
pour établir une chaine de filtre permettant la résolution du nom du
layout, vers le fichier y correspondant. Par défaut, les règles
"CamelCaseToDash" suivie de "StringToLower" sont utilisées. Le suffixe
"phtml" est ensuite ajouté :
"foo" sera transformé en "foo.phtml".
"FooBarBaz" sera transformé vers "foo-bar-baz.phtml".
Vous pouvez personnaliser l'inflecteur de 3 manières différentes :
Modifier la cible et/ou le suffixe grâce à des accesseurs dans
Zend_Layout ; Modifier les règles de l'inflecteur
associé à Zend_Layout ; Ou encore créer votre propre
inflecteur et le passer à Zend_Layout::setInflector().
Exemple #1 Utilisation des accesseurs pour modifier l'inflecteur
L'inflecteur par défaut de Zend_Layout utilise des
marqueurs statiques pour la cible et le suffixe. 2 accesseurs
vous sont donc proposés :
<?php
// Affecte une cible à l'inflecteur:
$layout->setInflectorTarget('layouts/:script.:suffix');
// Affecte le suffixe:
$layout->setViewSuffix('php');
?>Exemple #2 Modification directe de l'infecteur de Zend_Layout
Les inflecteurs fonctionnent avec un cible et plusieurs règles.
La cible par défaut utilisée pour Zend_Layout est
":script.:suffix" ; ":script" représente le nom du script de layout,
et ":suffix" est une règle statique.
Imaginons que vous vouliez que le suffixe du script de layout soit "html", et que vous vouliez séparer les mots en CasseMélangée ou en notationCamel avec des underscores au lieu des tirets. De plus, vous voulez chercher vos scripts dans un sous-dossier "layouts" :
<?php
$layout->getInflector()->setTarget('layouts/:script.:suffix')
->setStaticRule('suffix', 'html')
->setFilterRule(array('CamelCaseToUnderscore'));
?>Exemple #3 Inflecteur personnalisé
Dans la plupart des cas, modifier l'inflecteur sera suffisant.
Vous pouvez cependant créer votre propre inflecteur, pour l'utiliser
à différents endroits par exemple, et le passer à
Zend_Layout:
<?php
$inflector = new Zend_Filter_Inflector('layouts/:script.:suffix');
$inflector->addRules(array(
':script' => array('CamelCaseToUnderscore'),
'suffix' => 'html'
));
$layout->setInflector($inflector);
?>Note: L'inflecteur peut être désactivé
L'inflecteur peut être désactivé si vous spécifiez, par exemple, un chemin absolu pour un script utilisé parZend_Layout. Les méthodesenableInflection()etdisableInflection()vous y aideront.
| Zend_Layout options de configuration |
