Zend_Validate-Set.xml 6.8 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180
  1. <sect1 id="zend.validate.set" xmlns:xi="http://www.w3.org/2001/XInclude">
  2. <title>Clases de Validación Estándar</title>
  3. <para>
  4. Zend Framework viene con un conjunto estándar de clases de validación
  5. listas para usar.
  6. </para>
  7. <sect2 id="zend.validate.set.alnum">
  8. <title>Alnum</title>
  9. <para>
  10. Devuelve <code>true</code> si y sólo si <code>$valor</code> contiene
  11. caracteres alfanuméricos únicamente.
  12. Este validador incluye una opción para considerar también al espacio
  13. en blanco como caracter válido.
  14. </para>
  15. </sect2>
  16. <sect2 id="zend.validate.set.alpha">
  17. <title>Alpha</title>
  18. <para>
  19. Devuelve <code>true</code> si y sólo si <code>$valor</code> sólo
  20. contiene caracteres alfabéticos.
  21. Este validador incluye una opción para considerar también al espacio
  22. en blanco como caracter válido.
  23. </para>
  24. </sect2>
  25. <sect2 id="zend.validate.set.barcode">
  26. <title>Barcode</title>
  27. <para>
  28. Este validador es instanciado con un tipo de código de barras contra
  29. el valor del código de barras que quiere validar.
  30. En la actualidad acepta los tipos de código de barras "<code>UPC-A</code>"
  31. (Universal Product Code) y "<code>EAN-13</code>" (European Article Number),
  32. además el método <code>isValid()</code> devuelve verdadero si y solo si
  33. la entrada valida satisfactoriamente contra el algoritmo de validación
  34. del código de barras.
  35. Antes de enviar los datos de entrada al validador, debe asegurarse
  36. de eliminar todos los caracteres distintos a los dígitos cero a nueve (0-9).
  37. </para>
  38. </sect2>
  39. <sect2 id="zend.validate.set.between">
  40. <title>Between</title>
  41. <para>
  42. Devuelve <code>true</code> si y sólo si <code>$valor</code> está entre
  43. los valores límites mínimo y máximo.
  44. La comparación es inclusiva por defecto (<code>$valor</code> puede ser
  45. igual a una valor límite), aunque esto puede ser anulado a fin de
  46. hacer una comparación estricta, donde <code>$valor</code> debe ser
  47. estrictamente mayor al mínimo y estrictamente menor al máximo.
  48. </para>
  49. </sect2>
  50. <sect2 id="zend.validate.set.ccnum">
  51. <title>Ccnum</title>
  52. <para>
  53. Devuelve <code>true</code> si y sólo si <code>$valor</code> sigue el
  54. algoritmo Luhn (mod-10 checksum) para tarjetas de crédito.
  55. </para>
  56. </sect2>
  57. <sect2 id="zend.validate.set.date">
  58. <title>Date</title>
  59. <para>
  60. Devuelve <code>true</code> si y sólo si <code>$valor</code> es una
  61. fecha válida en el formato <code>YYYY-MM-DD</code> (AAAA-MM-DD).
  62. Si se usa la opción <code>locale</code> entonces la fecha
  63. será validada de acuerdo a lo establecido para ese lugar.
  64. El formato <code>format</code> es una opción que establece este
  65. formato a ser utilizado para la validación.
  66. Para los detalles acerca de los parámetros opcionales ver en:
  67. <link linkend="zend.date.others.comparison.table">Zend_Date::isDate()</link>.
  68. </para>
  69. </sect2>
  70. <sect2 id="zend.validate.set.digits">
  71. <title>Digits</title>
  72. <para>
  73. Devuelve <code>true</code> si y sólo si <code>$valor</code> contiene
  74. solamente dígitos.
  75. </para>
  76. </sect2>
  77. <!--
  78. <xi:include href="Zend_Validate-EmailAddress.xml" />
  79. -->
  80. <sect2 id="zend.validate.set.float">
  81. <title>Float</title>
  82. <para>
  83. Devuelve <code>true</code> si y sólo si <code>$valor</code> es un
  84. valor de punto flotante.
  85. </para>
  86. </sect2>
  87. <sect2 id="zend.validate.set.greater_than">
  88. <title>GreaterThan</title>
  89. <para>
  90. Devuelve <code>true</code> si y sólo si <code>$valor</code> es mayor
  91. al límite mínimo.
  92. </para>
  93. </sect2>
  94. <sect2 id="zend.validate.set.hex">
  95. <title>Hex</title>
  96. <para>
  97. Devuelve <code>true</code> si y sólo si <code>$valor</code> contiene
  98. caracteres hexadecimales (0-9 y A-F).
  99. </para>
  100. </sect2>
  101. <xi:include href="Zend_Validate-Hostname.xml" />
  102. <sect2 id="zend.validate.set.in_array">
  103. <title>InArray</title>
  104. <para>
  105. Devuelve <code>true</code> si y sólo si <code>$valor</code> se encuentra
  106. en un array, y si la opción es estricta entonces también verificará
  107. el tipo de dato de <code>$valor</code>.
  108. </para>
  109. </sect2>
  110. <sect2 id="zend.validate.set.int">
  111. <title>Int</title>
  112. <para>
  113. Devuelve <code>true</code> si y sólo si <code>$valor</code> es un valor entero válido.
  114. </para>
  115. </sect2>
  116. <sect2 id="zend.validate.set.ip">
  117. <title>Ip</title>
  118. <para>
  119. Devuelve <code>true</code> si y sólo si <code>$valor</code> es una dirección IP válida.
  120. </para>
  121. </sect2>
  122. <sect2 id="zend.validate.set.less_than">
  123. <title>LessThan</title>
  124. <para>
  125. Devuelve <code>true</code> si y sólo si <code>$valor</code> es menor
  126. al límite máximo.
  127. </para>
  128. </sect2>
  129. <sect2 id="zend.validate.set.not_empty">
  130. <title>NotEmpty</title>
  131. <para>
  132. Devuelve <code>true</code> si y sólo si <code>$valor</code> no es vacío.
  133. </para>
  134. </sect2>
  135. <sect2 id="zend.validate.set.regex">
  136. <title>Regex</title>
  137. <para>
  138. Devuelve <code>true</code> si y sólo si <code>$valor</code> coincide
  139. con el patrón de una expresión regular.
  140. </para>
  141. </sect2>
  142. <sect2 id="zend.validate.set.string_length">
  143. <title>StringLength</title>
  144. <para>
  145. Devuelve <code>true</code> si y sólo si la longitud del string <code>$valor</code>
  146. es por lo menos un mínimo y no mayor a un máximo
  147. (cuando la opción max no es <code>null</code>).
  148. Desde la versión 1.5.0, el método <code>setMin()</code> lanza una
  149. excepción si la longitud mínima tiene un valor mayor que la longitud
  150. máxima establecida, y el método <code>setMax()</code> lanza una excepción si la
  151. longitud máxima se fija a un valor inferior que la longitud
  152. mínima establecida. Desde la versión 1.0.2, esta clase soporta UTF-8 y a otras
  153. codificaciones, basado en el valor actual de:
  154. <ulink url="http://www.php.net/manual/en/ref.iconv.php#iconv.configuration"><code>iconv.internal_encoding</code></ulink>.
  155. </para>
  156. </sect2>
  157. </sect1>
  158. <!--
  159. vim:se ts=4 sw=4 et:
  160. -->