documentation/manual/es/module_specs/Zend_Validate-Set.xml

   1 <?xml version="1.0" encoding="UTF-8"?>
   2 <!-- EN-Revision: 20229 -->
   3     <!-- Reviewed: no -->
   4
   5 <sect1 id="zend.validate.set" xmlns:xi="http://www.w3.org/2001/XInclude">
   6
   7     <title>Clases de Validación Estándar</title>
   8
   9     <para>Zend Framework viene con un conjunto estándar de clases de validación
  10         listas para usar.</para>
  11
  12     <sect2 id="zend.validate.set.alnum">
  13         <title>Alnum</title>
  14         <para> Devuelve <constant>TRUE</constant> si y sólo si
  15                 <varname>$valor</varname> contiene caracteres alfanuméricos
  16             únicamente. Este validador incluye una opción para considerar
  17             también al espacio en blanco como caracter válido. </para>
  18     </sect2>
  19
  20     <note>
  21         <para>Los caracteres alfabéticos significan caracteres que componen
  22             palabras en cada idioma. Sin embargo, el alfabeto inglés es tratado
  23             como caracteres alfabéticos en los siguientes idiomas: chino,
  24             japonés, coreano. El lenguaje es especificado por
  25             Zend_Locale.</para>
  26     </note>
  27
  28     <sect2 id="zend.validate.set.alpha">
  29         <title>Alpha</title>
  30         <para> Devuelve <constant>TRUE</constant> si y sólo si
  31                 <varname>$valor</varname> sólo contiene caracteres alfabéticos.
  32             Este validador incluye una opción para considerar también al espacio
  33             en blanco como caracter válido. </para>
  34     </sect2>
  35
  36     <xi:include href="Zend_Validate-Barcode.xml"/>
  37
  38     <sect2 id="zend.validate.set.between">
  39         <title>Between</title>
  40         <para> Devuelve <constant>TRUE</constant> si y sólo si
  41                 <varname>$valor</varname> está entre los valores límites mínimo
  42             y máximo. La comparación es inclusiva por defecto (
  43                 <varname>$valor</varname> puede ser igual a una valor límite),
  44             aunque esto puede ser anulado a fin de hacer una comparación
  45             estricta, donde <varname>$valor</varname> debe ser estrictamente
  46             mayor al mínimo y estrictamente menor al máximo. </para>
  47     </sect2>
  48
  49     <xi:include href="Zend_Validate-Callback.xml"/>
  50     <xi:include href="Zend_Validate-CreditCard.xml"/>
  51
  52     <sect2 id="zend.validate.set.ccnum">
  53         <title>Ccnum</title>
  54         <para> Devuelve <constant>TRUE</constant> si y sólo si
  55                 <varname>$valor</varname> sigue el algoritmo Luhn (mod-10
  56             checksum) para tarjetas de crédito. </para>
  57
  58         <note>
  59             <para> The <classname>Ccnum</classname> validator has been
  60                 deprecated in favor of the <classname>CreditCard</classname>
  61                 validator. For security reasons you should use CreditCard
  62                 instead of Ccnum. </para>
  63         </note>
  64     </sect2>
  65
  66     <sect2 id="zend.validate.set.date">
  67         <title>Date</title>
  68         <para> Devuelve <constant>TRUE</constant> si y sólo si
  69                 <varname>$valor</varname> es una fecha válida en el formato
  70                 <methodname>YYYY-MM-DD</methodname> (AAAA-MM-DD). Si se usa la
  71             opción <methodname>locale</methodname> entonces la fecha será
  72             validada de acuerdo a lo establecido para ese locale. Además, si se
  73             establece la opción <methodname>format</methodname> ese formato se
  74             utiliza para la validación. Para más detalles acerca de los
  75             parámetros opcionales ver en: <link
  76                 linkend="zend.date.others.comparison.table"
  77                 >Zend_Date::isDate()</link> . </para>
  78     </sect2>
  79
  80     <xi:include href="Zend_Validate-Db.xml">
  81         <xi:fallback href="../../en/module_specs/Zend_Validate-Db.xml"/>
  82     </xi:include>
  83     <sect2 id="zend.validate.set.digits">
  84         <title>Digits</title>
  85         <para> Devuelve <constant>TRUE</constant> si y sólo si
  86                 <varname>$valor</varname> contiene solamente dígitos. </para>
  87     </sect2>
  88
  89     <xi:include href="Zend_Validate-EmailAddress.xml">
  90         <xi:fallback href="../../en/module_specs/Zend_Validate-EmailAddress.xml"
  91         />
  92     </xi:include>
  93     <sect2 id="zend.validate.set.float">
  94         <title>Float</title>
  95         <para> Devuelve <constant>TRUE</constant> si y sólo si
  96                 <varname>$value</varname> es un valor de punto flotante. Desde
  97             Zend Framework 1.8 toma en cuenta la localizacion actual del
  98             navegador, las variables o el uso. Puede usar get/setLocale para
  99             cambiar la configuracion regional o crear una instancia para este
 100             validador </para>
 101     </sect2>
 102
 103     <sect2 id="zend.validate.set.greater_than">
 104         <title>GreaterThan</title>
 105         <para> Devuelve <constant>TRUE</constant> si y sólo si
 106                 <varname>$valor</varname> es mayor al límite mínimo. </para>
 107     </sect2>
 108
 109     <sect2 id="zend.validate.set.hex">
 110         <title>Hex</title>
 111         <para> Devuelve <constant>TRUE</constant> si y sólo si
 112                 <varname>$valor</varname> contiene caracteres hexadecimales (0-9
 113             y A-F). </para>
 114     </sect2>
 115
 116     <xi:include href="Zend_Validate-Hostname.xml"/>
 117
 118     <sect2 id="zend.validate.set.iban">
 119         <title>Iban</title>
 120         <para> Returns <constant>TRUE</constant> if and only if
 121                 <varname>$value</varname> contains a valid IBAN (International
 122             Bank Account Number). IBAN numbers are validated against the country
 123             where they are used and by a checksum. </para>
 124
 125         <para>There are two ways to validate IBAN numbers. As first way you can
 126             give a locale which represents a country. Any given IBAN number will
 127             then be validated against this country.</para>
 128         <programlisting language="php"><![CDATA[
 129 $validator = new Zend_Validate_Iban('de_AT');
 130 $iban = 'AT611904300234573201';
 131 if ($validator->isValid($iban)) {
 132     // IBAN appears to be valid
 133 } else {
 134     // IBAN is invalid
 135     foreach ($validator->getMessages() as $message) {
 136         echo "$message\n";
 137     }
 138 }
 139 ]]></programlisting>
 140         <para>This should be done when you want to validate IBAN numbers for a
 141             single countries. The simpler way of validation is not to give a
 142             locale like shown in the next example.</para>
 143         <programlisting language="php"><![CDATA[
 144 $validator = new Zend_Validate_Iban();
 145 $iban = 'AT611904300234573201';
 146 if ($validator->isValid($iban)) {
 147     // IBAN appears to be valid
 148 } else {
 149     // IBAN is invalid
 150 }
 151 ]]></programlisting>
 152         <para>But this shows one big problem: When you have to accept only IBAN
 153             numbers from one single country, for example france, then IBAN
 154             numbers from other countries would also be valid. Therefor just
 155             remember: When you have to validate a IBAN number against a defined
 156             country you should give the locale. And when you accept all IBAN
 157             numbers regardless of any country omit the locale for
 158             simplicity.</para>
 159     </sect2>
 160
 161     <sect2 id="zend.validate.set.in_array">
 162         <title>InArray</title>
 163         <para> Devuelve <constant>TRUE</constant> si y sólo si
 164                 <varname>$valor</varname> se encuentra en un array, y si la
 165             opción es estricta entonces también verificará el tipo de dato de
 166                 <varname>$valor</varname> . </para>
 167     </sect2>
 168
 169     <xi:include href="Zend_Validate-Identical.xml"/>
 170     <xi:include href="Zend_Validate-InArray.xml"/>
 171
 172     <sect2 id="zend.validate.set.int">
 173         <title>Int</title>
 174         <para> Returns <constant>TRUE</constant> if and only if
 175                 <varname>$value</varname> is a valid integer. Since Zend
 176             Framework 1.8 this validator takes into account the actual locale
 177             from browser, environment or application wide set locale. You can of
 178             course use the get/setLocale accessors to change the used locale or
 179             give it while creating a instance of this validator. </para>
 180     </sect2>
 181
 182     <xi:include href="Zend_Validate-Ip.xml"/>
 183      <xi:include href="Zend_Validate-Isbn.xml" />
 184
 185     <sect2 id="zend.validate.set.less_than">
 186         <title>LessThan</title>
 187         <para> Devuelve <constant>TRUE</constant> si y sólo si
 188                 <varname>$valor</varname> es menor al límite máximo. </para>
 189     </sect2>
 190
 191     <xi:include href="Zend_Validate-NotEmpty.xml"/>
 192
 193     <xi:include href="Zend_Validate-PostCode.xml"/>
 194
 195     <sect2 id="zend.validate.set.regex">
 196         <title>Regex</title>
 197         <para> Devuelve <constant>TRUE</constant> si y sólo si
 198                 <varname>$valor</varname> coincide con el patrón de una
 199             expresión regular. </para>
 200     </sect2>
 201
 202     <xi:include href="Zend_Validate-Sitemap.xml">
 203         <xi:fallback>
 204             <xi:include href="../../en/module_specs/Zend_Validate-Sitemap.xml"/>
 205         </xi:fallback>
 206     </xi:include>
 207
 208     <sect2 id="zend.validate.set.string_length">
 209         <title>StringLength</title>
 210         <para> Devuelve <constant>TRUE</constant> si y sólo si la longitud del
 211             string <varname>$valor</varname> es por lo menos un mínimo y no
 212             mayor a un máximo (cuando la opción max no es
 213                 <constant>NULL</constant> ). Desde la versión 1.5.0, el método
 214                 <methodname>setMin()</methodname> lanza una excepción si la
 215             longitud mínima tiene un valor mayor que la longitud máxima
 216             establecida, y el método <methodname>setMax()</methodname> lanza una
 217             excepción si la longitud máxima se fija a un valor inferior que la
 218             longitud mínima establecida. Desde la versión 1.0.2, esta clase
 219             soporta UTF-8 y a otras codificaciones, basado en el valor actual
 220             de: <ulink
 221                 url="http://www.php.net/manual/en/ref.iconv.php#iconv.configuration"
 222                 > iconv.internal_encoding </ulink> . If you need a different
 223             encoding you can set it with the accessor methods getEncoding and
 224             setEncoding. </para>
 225     </sect2>
 226
 227 </sect1>