documentation/manual/fr/module_specs/Zend_Validate-Isbn.xml

   1 <?xml version="1.0" encoding="UTF-8"?>
   2 <!-- EN-Revision: 21815 -->
   3 <!-- Reviewed: no -->
   4 <sect2 id="zend.validate.set.isbn">
   5     <title>Isbn</title>
   6
   7     <para>
   8         <classname>Zend_Validate_Isbn</classname> permet de valider des valeurs
   9         <acronym>ISBN-10</acronym> ou <acronym>ISBN-13</acronym>.
  10     </para>
  11
  12     <sect3 id="zend.validate.set.isbn.options">
  13         <title>Options supportées par Zend_Validate_Isbn</title>
  14
  15         <para>
  16             Les options suivantes sont supportées par
  17             <classname>Zend_Validate_Isbn</classname>&#160;:
  18         </para>
  19
  20         <itemizedlist>
  21             <listitem>
  22                 <para>
  23                     <emphasis><property>separator</property></emphasis>&#160;: définit le séparateur
  24                     autorisé pour la valeur <acronym>ISBN</acronym>. Par défaut, il s'agit d'une
  25                     chaîne vide.
  26                 </para>
  27             </listitem>
  28
  29             <listitem>
  30                 <para>
  31                     <emphasis><property>type</property></emphasis>&#160;: définit le type des
  32                     valeurs <acronym>ISBN</acronym> autorisées. Par défaut, il s'agit de
  33                     <constant>Zend_Validate_Isbn::AUTO</constant>. Pour plus de détails reportez
  34                     vous à
  35                     <link linkend="zend.validate.set.isbn.type-explicit">cette section</link>.
  36                 </para>
  37             </listitem>
  38         </itemizedlist>
  39     </sect3>
  40
  41     <sect3 id="zend.validate.set.isbn.basic">
  42         <title>Utilisation classique</title>
  43
  44         <para>
  45             Voici un exemple banal&#160;:
  46         </para>
  47
  48         <programlisting language="php"><![CDATA[
  49 $validator = new Zend_Validate_Isbn();
  50 if ($validator->isValid($isbn)) {
  51     // isbn valide
  52 } else {
  53     // isbn non valide
  54 }
  55 ]]></programlisting>
  56
  57         <para>
  58             Ceci valide tout <acronym>ISBN-10</acronym> et <acronym>ISBN-13</acronym> sans
  59             séparateur.
  60         </para>
  61     </sect3>
  62
  63     <sect3 id="zend.validate.set.isbn.type-explicit">
  64         <title>Configurer un type de validation ISBN explicite</title>
  65
  66         <para>
  67             Voici comment effectuer une restriction de type de l'<acronym>ISBN</acronym>&#160;:
  68         </para>
  69
  70         <programlisting language="php"><![CDATA[
  71 $validator = new Zend_Validate_Isbn();
  72 $validator->setType(Zend_Validate_Isbn::ISBN13);
  73 // OU
  74 $validator = new Zend_Validate_Isbn(array(
  75     'type' => Zend_Validate_Isbn::ISBN13,
  76 ));
  77
  78 if ($validator->isValid($isbn)) {
  79     // ISBN-13 valide
  80 } else {
  81     // ISBN-13 invalide
  82 }
  83 ]]></programlisting>
  84
  85         <para>
  86             Seules les valeurs de <acronym>ISBN-13</acronym> sont validées ci-dessus.
  87         </para>
  88
  89         <para>
  90             Les types valides sont&#160;:
  91         </para>
  92
  93         <itemizedlist>
  94             <listitem>
  95                 <para><constant>Zend_Validate_Isbn::AUTO</constant> (défaut)</para>
  96             </listitem>
  97
  98             <listitem>
  99                 <para><constant>Zend_Validate_Isbn::ISBN10</constant></para>
 100             </listitem>
 101
 102             <listitem>
 103                 <para><constant>Zend_Validate_Isbn::ISBN13</constant></para>
 104             </listitem>
 105         </itemizedlist>
 106     </sect3>
 107
 108     <sect3 id="zend.validate.set.isbn.separator">
 109         <title>Spécifier une restriction de séparateur</title>
 110
 111         <para>
 112             Voici un exemple de restriction de séparateur&#160;:
 113         </para>
 114
 115         <programlisting language="php"><![CDATA[
 116 $validator = new Zend_Validate_Isbn();
 117 $validator->setSeparator('-');
 118 // OU
 119 $validator = new Zend_Validate_Isbn(array(
 120     'separator' => '-',
 121 ));
 122
 123 if ($validator->isValid($isbn)) {
 124     // ISBN valide avec séparateur
 125 } else {
 126     // ISBN invalide avec séparateur
 127 }
 128 ]]></programlisting>
 129
 130         <note>
 131             <title>Valeurs sans séparateur</title>
 132
 133             <para>
 134                 La valeur <constant>FALSE</constant> est retournée si <varname>$isbn</varname>
 135                 ne contient pas de séparateur <emphasis>ou</emphasis> si le séparateur n'est
 136                 pas valide.
 137             </para>
 138         </note>
 139
 140         <para>
 141             Séparateurs valides&#160;:
 142         </para>
 143
 144         <itemizedlist>
 145             <listitem>
 146                 <para>"" (vide) (défaut)</para>
 147             </listitem>
 148             <listitem>
 149                 <para>"-" (tiret)</para>
 150             </listitem>
 151             <listitem>
 152                 <para>" " (espace)</para>
 153             </listitem>
 154         </itemizedlist>
 155     </sect3>
 156 </sect2>