1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
|
<?xml version="1.0" encoding="UTF-8"?>
<!-- EN-Revision: 24249 -->
<!-- Reviewed: no -->
<sect1 id="zend.view.controllers">
<title>Scripts de contrôleur</title>
<para>
Le contrôleur est l'endroit où vous instanciez et configurez
<classname>Zend_View</classname>. Vous assignez ensuite des variables à la vue, et lui dites
comment effectuer le rendu en utilisant un script particulier.
</para>
<sect2 id="zend.view.controllers.assign">
<title>Assigner des variables</title>
<para>
Votre script de contrôleur devrait assigner les variables nécessaires à la vue
avant de passer le contrôle au script de vue. Normalement vous pouvez faire les
assignations une par une en assignant les noms des propriétés de l'instance de la vue
:
</para>
<programlisting language="php"><![CDATA[
$view = new Zend_View();
$view->a = "Ha";
$view->b = "Bé";
$view->c = "Cé";
]]></programlisting>
<para>
Cependant, ceci peut être pénible quand vous avez déjà collecté (dans un tableau
ou dans un objet) les valeurs à assigner.
</para>
<para>
La méthode <methodname>assign()</methodname> vous laisse assigner "en vrac" depuis un tableau
ou un objet. Les exemples suivants ont le même effet que celui ci-dessus.
</para>
<programlisting language="php"><![CDATA[
$view = new Zend_View();
// assigne un tableau de paires clés/valeurs, où la clé
// est le nom de la variable, et la valeur, sa valeur assignée
$array = array(
'a' => "Ha",
'b' => "Bé",
'c' => "Cé",
);
$view->assign($array);
// fait pareil avec les propriétés publiques d'un objet
// notez le transtypage lors de l'assignation
$obj = new StdClass;
$obj->a = "Ha";
$obj->b = "Bé";
$obj->c = "Cé";
$view->assign((array) $obj);
]]></programlisting>
<para>
Alternativement, vous pouvez utiliser la méthode <methodname>assign()</methodname> pour
assigner les variables une par une, en passant le nom de la variable, et sa
valeur.
</para>
<programlisting language="php"><![CDATA[
$view = new Zend_View();
$view->assign('a', "Ha");
$view->assign('b', "Bé");
$view->assign('c', "Cé");
]]></programlisting>
</sect2>
<sect2 id="zend.view.controllers.render">
<title>Effectuer le rendu d'un script de vue</title>
<para>
Une fois que vous avez assigné toutes les variables dont vous avez besoin, le
contrôleur devrait demander à <classname>Zend_View</classname> de rendre un script de
vue particulier. Faites cela en appelant la méthode <methodname>render()</methodname>. Notez que la
méthode va retourner la vue rendue, mais ne va pas l'afficher, vous devez donc
l'afficher vous même avec <code>print</code> ou <code>echo</code>, au moment
voulu.
</para>
<programlisting language="php"><![CDATA[
$view = new Zend_View();
$view->a = "Ha";
$view->b = "Bé";
$view->c = "Cé";
echo $view->render('uneVue.php');
]]></programlisting>
</sect2>
<sect2 id="zend.view.controllers.script-paths">
<title>Chemin des scripts de vue</title>
<para>
Par défaut, <classname>Zend_View</classname> s'attend à ce que vos scripts de vues
soient dans le même dossier que celui du contrôleur. Par exemple, si le script du
contrôleur est dans "/chemin/des/controleurs" et qu'il appelle
<code>$view->render('uneVue.php')</code>, <classname>Zend_View</classname> va
rechercher "/chemin/des/controleurs/uneVue.php".
</para>
<para>
Évidemment, vos scripts sont peut-être localisés ailleurs. Pour dire à
<classname>Zend_View</classname> ou il doit chercher, utilisez la méthode
<methodname>setScriptPath()</methodname>.
</para>
<programlisting language="php"><![CDATA[
$view = new Zend_View();
$view->setScriptPath('/chemin/des/vues');
]]></programlisting>
<para>
Maintenant, vous appelez <code>$view->render('uneVue.php')</code>, il va
rechercher dans "<filename>/chemin/des/vues/uneVue.php</filename>".
</para>
<para>
En fait, vous pouvez "empiler" les chemins en utilisant la méthode
<methodname>setScriptPath()</methodname>. Comme vous ajoutez des chemins dans la pile,
<classname>Zend_View</classname> va rechercher le script de vue dans le chemin le plus
récemment ajouté. Cela vous permet de passer outre les vues par défaut, pour des vues
personnalisées. Ainsi vous pouvez créer des "thèmes" ou des "skins" pour certaines vues,
pendant que vous laissez les autres intactes.
</para>
<programlisting language="php"><![CDATA[
$view = new Zend_View();
$view->addScriptPath('/chemin/des/vues');
$view->addScriptPath('/chemin/des/vues-personnalisees');
// maintenant, lorsque vous appelerez $view->render('listelivre.php'),
// Zend_View va rechercher en premier dans
// "/chemin/des/vues-personnalisees/listelivre.php", puis
// dans "/chemin/des/vues/listelivre.php", et ensuite dans le répertoire
// courant pour trouver le fichier "listelivre.php".
]]></programlisting>
<note>
<title>Ne jamais utiliser une entrée utilisateur pour spécifier les chemins vers les
scripts de vues</title>
<para>
<classname>Zend_View</classname> utilise des chemins dans lesquels elle
cherche et effectue le rendu des scripts de vues. En soi, ces dossiers devraient
être connus à l'avance, et sous votre contrôle. <emphasis>Ne jamais</emphasis>
spécifier des dossiers de scripts de vues sur la base d'une entrée utilisateur, car
vous pourriez ainsi avoir une vulnérabilité d'inclusion de fichier non voulu si les
chemins spécifiés par l'utilisateur sont traversant. Par exemple, le code suivant
peut générer un problème :
</para>
<programlisting language="php"><![CDATA[
// $_GET['foo'] == '../../../etc'
$view->addScriptPath($_GET['foo']);
$view->render('passwd');
]]></programlisting>
<para>
De la manière dont cet exemple est conçu, il montre clairement le problème
potentiel. Si vous <emphasis>devez</emphasis> compter sur l'entrée d'utilisateur
pour placer votre chemin de scripts, filtrez correctement l'entrée et contrôlez pour
vous assurer que ces chemins sont contrôlés par votre application.
</para>
</note>
</sect2>
</sect1>
|
