documentation/manual/fr/ref/migration-16.xml

   1 <?xml version="1.0" encoding="UTF-8"?>
   2 <!-- EN-Revision: 20876 -->
   3 <!-- Reviewed: no -->
   4 <sect1 id="migration.16">
   5     <title>Zend Framework 1.6</title>
   6
   7     <para>
   8         Lors de la migration d'un version précédente vers Zend Framework 1.6 ou plus récent
   9         vous devriez prendre note de ce qui suit.
  10     </para>
  11
  12     <sect2 id="migration.16.zend.controller">
  13         <title>Zend_Controller</title>
  14
  15         <sect3 id="migration.16.zend.controller.dispatcher">
  16             <title>Changement dans l'interface Dispatcher</title>
  17
  18             <para>
  19                 Les utilisateurs ont porté à notre connaissance le fait que
  20                 <classname>Zend_Controller_Front</classname> et
  21                 <classname>Zend_Controller_Router_Route_Module</classname> utilisent tous les deux
  22                 des méthodes du distributeur qui ne sont pas dans l'interface associée. Nous avons
  23                 donc ajouté les trois méthodes suivantes pour s'assurer que les distributeurs
  24                 personnalisés continueront à fonctionner avec les implémentations embarquées&#160;:
  25             </para>
  26
  27             <itemizedlist>
  28                 <listitem>
  29                     <para>
  30                         <methodname>getDefaultModule()</methodname>&#160;: retourne le nom du module par
  31                         défaut.
  32                     </para>
  33                 </listitem>
  34                 <listitem>
  35                     <para>
  36                         <methodname>getDefaultControllerName()</methodname>&#160;: retourne le nom du
  37                         contrôleur par défaut.
  38                     </para>
  39                 </listitem>
  40                 <listitem>
  41                     <para>
  42                         <methodname>getDefaultAction()</methodname>&#160;: retourne le nom de l'action par
  43                         défaut.
  44                     </para>
  45                 </listitem>
  46             </itemizedlist>
  47         </sect3>
  48     </sect2>
  49
  50     <sect2 id="migration.16.zend.file.transfer">
  51         <title>Zend_File_Transfer</title>
  52
  53         <sect3 id="migration.16.zend.file.transfer.validators">
  54             <title>Changements quand vous utilisez des validateurs</title>
  55
  56             <para>
  57                 Certaines remarques des utilisateurs indiquaient que les validateurs de
  58                 <classname>Zend_File_Transfer</classname> ne fonctionnaient pas comme ceux par
  59                 défaut fournis avec <classname>Zend_Form</classname>.
  60                 <classname>Zend_Form</classname> permet par exemple l'utilisation du paramètre
  61                 <code>breakChainOnFailure</code> qui stoppe la validation de tous les validateurs
  62                 suivants dès qu'une erreur de validation apparaît.
  63             </para>
  64
  65             <para>
  66                 Nous avons donc ajouter ce paramètre à tous les validateurs existants pour
  67                 <classname>Zend_File_Transfer</classname>.
  68             </para>
  69
  70             <itemizedlist>
  71                 <listitem>
  72                     <para>
  73                         Ancienne <acronym>API</acronym>&#160;: <code>addValidator($validator, $options,
  74                         $files)</code>.
  75                     </para>
  76                 </listitem>
  77
  78                 <listitem>
  79                     <para>
  80                         Nouvelle <acronym>API</acronym>&#160;: <code>addValidator($validator, $breakChainOnFailure,
  81                         $options, $files)</code>.
  82                     </para>
  83                 </listitem>
  84             </itemizedlist>
  85
  86             <para>
  87                 Pour migrer vos scripts vers la nouvelle <acronym>API</acronym>, ajoutez simplement un a
  88                 <constant>FALSE</constant> après voir défini le validateur souhaité.
  89             </para>
  90
  91             <example id="migration.16.zend.file.transfer.example">
  92                 <title>Changer les validateurs de fichiers de 1.6.1 vers 1.6.2</title>
  93
  94                 <programlisting language="php"><![CDATA[
  95 // Exemple pour 1.6.1
  96 $upload = new Zend_File_Transfer_Adapter_Http();
  97 $upload->addValidator('FilesSize', array('1B', '100kB'));
  98
  99 // Même exemple pour 1.6.2 et plus récent
 100 // Notez l'ajout du booléen false
 101 $upload = new Zend_File_Transfer_Adapter_Http();
 102 $upload->addValidator('FilesSize', false, array('1B', '100kB'));
 103 ]]></programlisting>
 104             </example>
 105         </sect3>
 106     </sect2>
 107 </sect1>