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

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

    <para>
        <classname>Zend_Validate_Isbn</classname> permet de valider des valeurs
        <acronym>ISBN-10</acronym> ou <acronym>ISBN-13</acronym>.
    </para>

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

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

        <itemizedlist>
            <listitem>
                <para>
                    <emphasis><property>separator</property></emphasis>&#160;: définit le séparateur
                    autorisé pour la valeur <acronym>ISBN</acronym>. Par défaut, il s'agit d'une
                    chaîne vide.
                </para>
            </listitem>

            <listitem>
                <para>
                    <emphasis><property>type</property></emphasis>&#160;: définit le type des
                    valeurs <acronym>ISBN</acronym> autorisées. Par défaut, il s'agit de
                    <constant>Zend_Validate_Isbn::AUTO</constant>. Pour plus de détails reportez
                    vous à
                    <link linkend="zend.validate.set.isbn.type-explicit">cette section</link>.
                </para>
            </listitem>
        </itemizedlist>
    </sect3>

    <sect3 id="zend.validate.set.isbn.basic">
        <title>Utilisation classique</title>

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

        <programlisting language="php"><![CDATA[
$validator = new Zend_Validate_Isbn();
if ($validator->isValid($isbn)) {
    // isbn valide
} else {
    // isbn non valide
}
]]></programlisting>

        <para>
            Ceci valide tout <acronym>ISBN-10</acronym> et <acronym>ISBN-13</acronym> sans
            séparateur.
        </para>
    </sect3>

    <sect3 id="zend.validate.set.isbn.type-explicit">
        <title>Configurer un type de validation ISBN explicite</title>

        <para>
            Voici comment effectuer une restriction de type de l'<acronym>ISBN</acronym>&#160;:
        </para>

        <programlisting language="php"><![CDATA[
$validator = new Zend_Validate_Isbn();
$validator->setType(Zend_Validate_Isbn::ISBN13);
// OU
$validator = new Zend_Validate_Isbn(array(
    'type' => Zend_Validate_Isbn::ISBN13,
));

if ($validator->isValid($isbn)) {
    // ISBN-13 valide
} else {
    // ISBN-13 invalide
}
]]></programlisting>

        <para>
            Seules les valeurs de <acronym>ISBN-13</acronym> sont validées ci-dessus.
        </para>

        <para>
            Les types valides sont&#160;:
        </para>

        <itemizedlist>
            <listitem>
                <para><constant>Zend_Validate_Isbn::AUTO</constant> (défaut)</para>
            </listitem>

            <listitem>
                <para><constant>Zend_Validate_Isbn::ISBN10</constant></para>
            </listitem>

            <listitem>
                <para><constant>Zend_Validate_Isbn::ISBN13</constant></para>
            </listitem>
        </itemizedlist>
    </sect3>

    <sect3 id="zend.validate.set.isbn.separator">
        <title>Spécifier une restriction de séparateur</title>

        <para>
            Voici un exemple de restriction de séparateur&#160;:
        </para>

        <programlisting language="php"><![CDATA[
$validator = new Zend_Validate_Isbn();
$validator->setSeparator('-');
// OU
$validator = new Zend_Validate_Isbn(array(
    'separator' => '-',
));

if ($validator->isValid($isbn)) {
    // ISBN valide avec séparateur
} else {
    // ISBN invalide avec séparateur
}
]]></programlisting>

        <note>
            <title>Valeurs sans séparateur</title>

            <para>
                La valeur <constant>FALSE</constant> est retournée si <varname>$isbn</varname>
                ne contient pas de séparateur <emphasis>ou</emphasis> si le séparateur n'est
                pas valide.
            </para>
        </note>

        <para>
            Séparateurs valides&#160;:
        </para>

        <itemizedlist>
            <listitem>
                <para>"" (vide) (défaut)</para>
            </listitem>
            <listitem>
                <para>"-" (tiret)</para>
            </listitem>
            <listitem>
                <para>" " (espace)</para>
            </listitem>
        </itemizedlist>
    </sect3>
</sect2>