documentation/manual/nl/module_specs/Zend_View-Scripts.xml

   1 <sect1 id="zend.view.scripts">
   2
   3     <title>View Scripts</title>
   4
   5     <para>
   6         Eenmaal je controller de variabelen heeft toegewezen en render()
   7         heeft opgeroepen zal Zend_View het gevraagde view script oproepen
   8         en het binnenin de Zend_View instantie uitvoeren. Daarom wijzen
   9         referenties naar $this in je view scripts eigenlijk naar de
  10         Zend_View instantie zelf.
  11     </para>
  12
  13     <para>
  14         Variabelen die aan het view script werden toegewezen door de
  15         controller worden beschouwd als instantie-eigenschappen. Bijvoorbeeld,
  16         indien de controller een variabele 'iets' zou toewijzen, zou je
  17         ernaar verwijzen in je view script als $this->iets. (Dit laat je toe
  18         de variabelen die werden toegewezen te scheiden van de variabelen die
  19         intern zijn aan het script zelf.)
  20     </para>
  21
  22     <para>
  23         Bij wijze van geheugenverfrisser vindt je hieronder het view script van
  24         de Zend_View inleiding:
  25     </para>
  26
  27     <programlisting role="php"><![CDATA[<?php if ($this->books): ?>
  28
  29     <!-- Een tabel van enige boeken. -->
  30     <table>
  31         <tr>
  32             <th>Auteur</th>
  33             <th>Titel</th>
  34         </tr>
  35
  36         <?php foreach ($this->books as $key => $val): ?>
  37         <tr>
  38             <td><?php echo $this->escape($val['author']) ?></td>
  39             <td><?php echo $this->escape($val['title']) ?></td>
  40         </tr>
  41         <?php endforeach; ?>
  42
  43     </table>
  44
  45 <?php else: ?>
  46
  47     <p>Er zijn geen boeken af te beelden.</p>
  48
  49 <?php endif; ?>]]>
  50     </programlisting>
  51
  52     <sect2 id="zend.view.scripts.escaping">
  53
  54         <title>Escaping Output</title>
  55
  56         <para>
  57             Eén van de meest belangrijke taken die in een view script
  58             moeten worden uitgevoerd is die welke verzekert dat output
  59             op een korrekte wijze wordt ge-escaped; dit helpt, onder andere,
  60             cross-site scripting aanvallen te voorkomen. Behalve als je een
  61             functie, methode of helper gebruilt die zelf het escapen voor
  62             rekening neemt, zou je altijd variabelen moeten escapen als je
  63             ze output.
  64         </para>
  65
  66         <para>
  67             Zend_View komt met een methode escape() die veel van het escape
  68             werk voor je uitvoert.
  69         </para>
  70
  71         <programlisting role="php"><![CDATA[<?php
  72 // slecht gebruik van het view-script:
  73 echo $this->variable;
  74
  75 // goed gebruik van het view-script:
  76 echo $this->escape($this->variable);
  77 ?>]]>
  78         </programlisting>
  79
  80         <para>
  81             Standaard gebruikt de escape() methode de PHP functie htmlspecialchars()
  82             om data te escapen. Afhangende van jouw environment zou het kunnen dat je
  83             zou willen dat het escapen op een andere manier wordt uitgevoerd. Gebruik
  84             de setEscape() methode op controller niveau om Zend_View te laten weten
  85             welke escape callback te gebruiken.
  86         </para>
  87
  88         <programlisting role="php"><![CDATA[<?php
  89 // Maak een Zend_View instantie
  90 $view = new Zend_View();
  91
  92 // vertel het htmlentities te gebruiken als escape callback
  93 $view->setEscape('htmlentities');
  94
  95 // of vertel het een statische klassemethode te gebruiken als callback
  96 $view->setEscape(array('EenClass', 'methodeNaam'));
  97
  98 // of zelfs een instantiemethode
  99 $obj = new EenClass();
 100 $view->setEscape(array($obj, 'methodeNaam'));
 101
 102 // en geef dan je view weer
 103 echo $view->render(...);
 104 ?>]]>
 105         </programlisting>
 106
 107         <para>
 108             De callback functie of methode zou de waarde die ge-escaped moet
 109             worden als eerste parameter moeten nemen en alle andere parameters
 110             moeten optioneel zijn.
 111         </para>
 112
 113     </sect2>
 114
 115     <sect2 id="zend.view.scripts.templates">
 116
 117         <title>Template Systemen</title>
 118
 119         <para>
 120             Alhoewel PHP zelf een machtig template systeem is vinden
 121             vele developpeurs dat het een tè machtig of complex systeem
 122             is voor template designers. Daarom kan het view script
 123             gebruikt worden om een ander template objekt te instantiëren
 124             en te manipuleren, zoals een PHPLIB-stijl template. Het
 125             view script voor dit soort aktiviteir zou er als volgt
 126             kunnen uitzien:
 127         </para>
 128
 129         <programlisting role="php"><![CDATA[<?php
 130 include_once 'template.inc';
 131 $tpl = new Template();
 132
 133 if ($this->books) {
 134     $tpl->setFile(array(
 135         "boeklijst" => "boeklijst.tpl",
 136         "elkboek" => "elkboek.tpl",
 137     ));
 138
 139     foreach ($this->boeken as $key => $val) {
 140         $tpl->set_var('auteur', $this->escape($val['author']);
 141         $tpl->set_var('titel', $this->escape($val['title']);
 142         $tpl->parse("boeken", "elkboek", true);
 143     }
 144
 145     $tpl->pparse("output", "boeklijst");
 146 } else {
 147     $tpl->setFile("geenboeken", "geenboeken.tpl")
 148     $tpl->pparse("output", "geenboeken");
 149 }
 150 ?>]]>
 151         </programlisting>
 152
 153         <para>
 154             Dit zouden de template bestanden zijn:
 155         </para>
 156
 157         <programlisting role="html"><![CDATA[
 158 <!-- boeklijst.tpl -->
 159 <table>
 160     <tr>
 161         <th>Auteur</th>
 162         <th>Titel</th>
 163     </tr>
 164     {boeken}
 165 </table>
 166
 167 <!-- elkboek.tpl -->
 168     <tr>
 169         <td>{auteur}</td>
 170         <td>{titel}</td>
 171     </tr>
 172
 173 <!-- geenboeken.tpl -->
 174 <p>Er zijn geen boeken af te beelden.</p>
 175 ]]>
 176         </programlisting>
 177
 178     </sect2>
 179
 180 </sect1>
 181 <!--
 182 vim:se ts=4 sw=4 et:
 183 -->