examples.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: d353c6215d7c1194936a24f0f2921409389a2395 Maintainer: chuso Status: ready -->
<!-- Reviewed: no -->

<chapter xml:id="filter.examples" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
 &reftitle.examples;
 
 <section xml:id="filter.examples.validation">
  <title>Validación</title>
  <para>
   <example>
    <title>Validación de direcciones de correo con <function>filter_var</function></title>
    <programlisting role="php" xml:id="filter.examples.validation.email">
<![CDATA[
<?php
$email_a = 'joe@example.com';
$email_b = 'bogus';

if (filter_var($email_a, FILTER_VALIDATE_EMAIL)) {
    echo "Esta dirección de correo ($email_a) es válida.";
}
if (filter_var($email_b, FILTER_VALIDATE_EMAIL)) {
    echo "Esta dirección de correo ($email_b) es válida.";
}
?>
]]>
    </programlisting>
    &example.outputs;
    <screen>
<![CDATA[
Esta dirección de correo (joe@example.com) es válida.
]]>
    </screen>
   </example>
  </para>
  
  <para>
   <example>
    <title>Validación de direcciones IP con <function>filter_var</function></title>
    <programlisting role="php" xml:id="filter.examples.validation.ip">
<![CDATA[
<?php
$ip_a = '127.0.0.1';
$ip_b = '42.42';

if (filter_var($ip_a, FILTER_VALIDATE_IP)) {
    echo "Esta dirección IP (ip_a) es válida.";
}
if (filter_var($ip_b, FILTER_VALIDATE_IP)) {
    echo "Esta dirección IP (ip_b) es válida.";
}
?>
]]>
    </programlisting>
    &example.outputs;
    <screen>
<![CDATA[
Esta dirección IP (ip_b) es válida.
]]>
    </screen>
   </example>
  </para>
  
  <para>
   <example>
    <title>Pasando opciones a <function>filter_var</function></title>
    <programlisting role="php" xml:id="filter.examples.validation.options">
<![CDATA[
<?php
$int_a = '1';
$int_b = '-1';
$int_c = '4';
$options = array(
    'options' => array(
                      'min_range' => 0,
                      'max_range' => 3,
                      )
);
if (filter_var($int_a, FILTER_VALIDATE_INT, $options) !== FALSE) {
    echo "Este entero (int_a) es válido (entre 0 y 3).\n";
}
if (filter_var($int_b, FILTER_VALIDATE_INT, $options) !== FALSE) {
    echo "Este entero (int_b) es válido (entre 0 y 3).\n";
}
if (filter_var($int_c, FILTER_VALIDATE_INT, $options) !== FALSE) {
    echo "Este entero (int_c) es válido (entre 0 y 3).\n";
}

$options['options']['default'] = 1;
if (($int_c = filter_var($int_c, FILTER_VALIDATE_INT, $options)) !== FALSE) {
    echo "Este entero (int_c) es válido (entre 0 y 3) y es $int_c.";
}
?>
]]>
    </programlisting>
    &example.outputs;
    <screen>
<![CDATA[
Este entero (int_a) es válido (entre 0 y 3).
Este entero (int_c) es válido (entre 0 y 3) y es 1.
]]>
    </screen>
   </example>
  </para>
 </section>
 
 <section xml:id="filter.examples.sanitization">
  <title>Saneamiento</title>
  <para>
   <example>
    <title>Saneando y validando direcciones de correo</title>
    <programlisting role="php" xml:id="filter.examples.sanitization.email">
<![CDATA[
<?php
$a = 'joe@example.org';
$b = 'bogus - at - example dot org';
$c = '(bogus@example.org)';

$sanitized_a = filter_var($a, FILTER_SANITIZE_EMAIL);
if (filter_var($sanitized_a, FILTER_VALIDATE_EMAIL)) {
    echo "Esta dirección de correo saneada (a) es válida.\n";
}

$sanitized_b = filter_var($b, FILTER_SANITIZE_EMAIL);
if (filter_var($sanitized_b, FILTER_VALIDATE_EMAIL)) {
    echo "Esta dirección de correo saneada (b) es válida.\n";
} else {
    echo "Esta dirección de correo saneada (b) no es válida.\n";
}

$sanitized_c = filter_var($c, FILTER_SANITIZE_EMAIL);
if (filter_var($sanitized_c, FILTER_VALIDATE_EMAIL)) {
    echo "Esta dirección de correo saneada (c) es válida.\n";
    echo "Antes: $c\n";
    echo "Después:  $sanitized_c\n";    
}
?>
]]>
    </programlisting>
    &example.outputs;
    <screen>
<![CDATA[
Esta dirección de correo saneada (a) es válida.
Esta dirección de correo saneada (b) no es válida.
Esta dirección de correo saneada (c) es válida.
Antes: (bogus@example.org)
Después: bogus@example.org
]]>
    </screen>
   </example>
  </para>
  <para>
   <example>
    <title>Configuración de un filtro por omisión</title>
    <programlisting role="php" xml:id="filter.examples.sanitization.default_filter">
<![CDATA[
filter.default = full_special_chars
filter.default_flags = 0
]]>
    </programlisting>
   </example>
  </para>
 </section>
 
</chapter>

<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->