repo_zf1/documentation/manual/fr/module_specs/Zend_Validate-Alnum.xml

<?xml version="1.0" encoding="UTF-8"?>
<!-- EN-Revision: 24249 -->
<!-- Reviewed: no -->
<sect2 id="zend.validate.set.alnum">
    <title>Alnum</title>

    <para>
        <classname>Zend_Validate_Alnum</classname> permet de valider des données contenant des
        caractères alphabétiques et des chiffres. Il n'y a pas de limite de taille.
    </para>

    <sect3 id="zend.validate.set.alnum.options">
        <title>Options supportées par Zend_Validate_Alnum</title>

        <para>
            Les options suivantes sont supportées par
            <classname>Zend_Validate_Alnum</classname>&#160;:
        </para>

        <itemizedlist>
            <listitem>
                <para>
                    <emphasis><property>allowWhiteSpace</property></emphasis>&#160;: Si le
                    caractère d'espace doit être accepté ou non. Par défaut
                    <constant>FALSE</constant>.
                </para>
            </listitem>
        </itemizedlist>
    </sect3>

    <sect3 id="zend.validate.set.alnum.basic">
        <title>Utilisation de base</title>

        <para>
            Voici un exemple&#160;:
        </para>

        <programlisting language="php"><![CDATA[
$validator = new Zend_Validate_Alnum();
if ($validator->isValid('Abcd12')) {
    // value ne contient que des caractères autorisés
} else {
    // false
}
]]></programlisting>
    </sect3>

    <sect3 id="zend.validate.set.alnum.whitespace">
        <title>Utiliser les espaces</title>

        <para>
            Par défaut les caractères espaces ne sont pas acceptés car il ne font pas partie de
            l'alphabet. Cependant il existe un moyen de les accepter en entrée, ceci permet de
            valider des phrases complètes.
        </para>

        <para>
            Pour autoriser les espaces blancs vous devez passer l'option
            <property>allowWhiteSpace</property>. Ceci peut se faire à la création de l'objet ou
            ensuite au moyen des méthodes <methodname>setAllowWhiteSpace()</methodname> et
            <methodname>getAllowWhiteSpace()</methodname>.
        </para>

        <programlisting language="php"><![CDATA[
$validator = new Zend_Validate_Alnum(array('allowWhiteSpace' => true));
if ($validator->isValid('Abcd and 12')) {
    // value ne contient que des caractères autorisés
} else {
    // false
}
]]></programlisting>
    </sect3>

    <sect3 id="zend.validate.set.alnum.languages">
        <title>Utiliser des langues différentes</title>

        <para>
            En utilisant <classname>Zend_Validate_Alnum</classname>, la langue que l'utilisateur
            précise dans son navigateur sera utilisée pour autoriser ou non certains caractères.
            Ainsi si l'utilisateur règle son navigateur sur <emphasis>de</emphasis> pour de
            l'allemand, alors les caractères comme <emphasis>ä</emphasis>, <emphasis>ö</emphasis>
            et <emphasis>ü</emphasis> seront eux aussi autorisés.
        </para>

        <para>
            Les caractères autorisés dépendent donc complètement de la langue utilisée.
        </para>

        <para>
            Il existe actuellement 3 langues qui ne sont pas supportées pour ce validateur. Il
            s'agit du <emphasis>coréen</emphasis>, du <emphasis>japonais</emphasis> et du
            <emphasis>chinois</emphasis> car ces langues utilisent un alphabet dans lequel un seul
            caractère est fabriqué à base de multiples caractères.
        </para>

        <para>
            Dans le cas où vous utilisez ces langues, seule l'alphabet anglais sera utilisé pour la
            validation.
        </para>
    </sect3>
</sect2>