<sect2 id="zend.validate.set.email_address">

    <title>Dirección de Email</title>

    <para>
        <code>Zend_Validate_EmailAddress</code> Le permite validar una dirección 
        de email. El validador primero divide la dirección de email en la parte
        local @ nombre de host e intenta igualar a estos contra especificaciones 
        conocidas para direcciones y nombres de host para el correo electrónico.
    </para>

    <para>
        <emphasis role="strong">Utilización básica</emphasis>
    </para>

    <para>
        Un ejemplo básico de uso se ve a continuación:

        <programlisting role="php"><![CDATA[
$validator = new Zend_Validate_EmailAddress();
if ($validator->isValid($email)) {
    // El email parece ser válido
} else {
    // El email es inválido; muestre las razones
    foreach ($validator->getMessages() as $message) {
        echo "$message\n";
    }
}
]]>
        </programlisting>

        Esto coincide con el correo electrónico <code>$email</code> y si fracasa, 
        alimenta <code>$validator->getMessages()</code> con mensajes de error útiles.
    </para>

    <para>
        <emphasis role="strong">Partes locales complejas</emphasis>
    </para>

    <para>
        <code>Zend_Validate_EmailAddress</code> se comparará con cualquier 
        dirección de correo válida de acuardo a RFC2822. 
        Por ejemplo, correos electrónicos válidos incluyen <code>bob@domain.com</code> , 
        <code>bob+jones@domain.us</code> , <code>"bob@jones"@domain.com</code> y 
        <code>"bob jones"@domain.com</code>
    </para>

    <para>
        Algunos formatos obsoletos de email actualmente no validan 
        (por ejemplo los retornos de carro o "\" un caracter en una dirección 
        de correo electrónico).
    </para>

    <para>
        <emphasis role="strong">Validar diferentes tipos de nombres de host</emphasis>
    </para>

    <para>
        La parte nombre de host de una dirección de correo es validado contra 
        <link linkend="zend.validate.set.hostname"><code>Zend_Validate_Hostname</code></link>. 
        Por defecto sólo son aceptados nombres de host DNS de la forma 
        <code>domain.com</code>, aunque si lo desea también puede aceptar 
        direcciones IP y nombres de host locales.
    </para>

    <para>
        Para ello necesita instanciar a <code>Zend_Validate_EmailAddress</code> 
        pasando un parámetro para indicar el tipo de nombres de host que quiere aceptar. 
        Más detalles están incluidos en <code>Zend_Validate_EmailAddress</code>, 
        aunque abajo hay un ejemplo de cómo aceptar tanto nombres de host DNS y 
        locales:

        <programlisting role="php"><![CDATA[
$validator = new Zend_Validate_EmailAddress(
                    Zend_Validate_Hostname::ALLOW_DNS |
                    Zend_Validate_Hostname::ALLOW_LOCAL);
if ($validator->isValid($email)) {
    // email parece ser válido
} else {
    // email es inválido; muestre las razones
    foreach ($validator->getMessages() as $message) {
        echo "$message\n";
    }
}
]]>
        </programlisting>
    </para>

    <para>
        <emphasis role="strong">Verificar si el nombre de host realmente acepta email</emphasis>
    </para>

    <para>
        Sólo porque una dirección de correo electrónico está en el formato correcto, 
        no necesariamente significa que esa dirección de correo electrónico 
        existe realmente. Para ayudar a resolver este problema, puede usar la 
        validación MX para comprobar si existe una entrada MX (email) en el 
        registro DNS para correo electrónico en ese nombre de host. 
        Esto le dice que el nombre de host acepta email, pero no le dice si la
        dirección de correo electrónico exacta es válida en si misma.
    </para>

    <para>
        La comprobación MX no está activada por defecto y en este momento es 
        soportada sólo por plataformas UNIX. 
        Para habilitar el control MX puede pasar un segundo parámetro al 
        constructor <code>Zend_Validate_EmailAddress</code>.

        <programlisting role="php"><![CDATA[
$validator = new Zend_Validate_EmailAddress(Zend_Validate_Hostname::ALLOW_DNS,
                                            true);
]]>
        </programlisting>
        Alternativamente, para activar o desactivar la validación MX puede pasar 
        <code>true</code> o <code>false</code> a <code>$validator->setValidateMx()</code>.
    </para>

    <para>
        Al habilitarlo, se usarán las funciones de red para comprobar 
        la presencia de un registro MX en el nombre de host de la dirección 
        de correo electrónico que desea validar. 
        Tenga en cuenta esto probablemente hará más lento su script.
    </para>

    <para>
        <emphasis role="strong">Validating International Domains Names</emphasis>
    </para>

    <para>
        <code>Zend_Validate_EmailAddress</code> también comparará caracteres 
        internationales que existen en algunos dominios. 
        Esto se conoce como soporte de International Domain Name (IDN). 
        Está activado por defecto, aunque puede deshabilitarlo internamente 
        cambiando el ajuste a través del objeto <code>Zend_Validate_Hostname</code> 
        que existe en <code>Zend_Validate_EmailAddress</code>.

        <programlisting role="php"><![CDATA[
$validator->hostnameValidator->setValidateIdn(false);
]]>
        </programlisting>
        Sobre el uso de <code>setValidateIdn()</code> encontrará más información
        en la documentación de <code>Zend_Validate_Hostname</code>.
    </para>

    <para>
        Tenga en cuenta que los IDNs se validarán solo si 
        usted permite que nombres de host DNS sean validados.
    </para>

    <para>
        <emphasis role="strong">Validar Dominios de Nivel Superior (TLD)</emphasis>
    </para>

    <para>
        Por defecto, un nombre de host se cotejará con una lista conocida de TLDs. 
        Está activado por defecto, aunque puede deshabilitarlo cambiando el 
        ajuste a través del objeto interno <code>Zend_Validate_Hostname</code> 
        que existe en <code>Zend_Validate_EmailAddress</code>.

        <programlisting role="php"><![CDATA[
$validator->hostnameValidator->setValidateTld(false);
]]>
        </programlisting>
        Encontrará más información sobre el uso de <code>setValidateTld()</code> 
        en la documentación de <code>Zend_Validate_Hostname</code>.
    </para>

    <para>
        Tenga en cuenta que los TLDs se validarán solo si 
        usted permite que nombres de host DNS sean validados.
    </para>

</sect2>
<!--
vim:se ts=4 sw=4 et:
-->
