repo_zf1/documentation/manual/fr/module_specs/Zend_Currency-Usage.xml

<?xml version="1.0" encoding="UTF-8"?>
<!-- EN-Revision: 20100 -->
<!-- Reviewed: no -->
<sect1 id="zend.currency.usage">
    <title>Utiliser Zend_Currency</title>

    <sect2 id="zend.currency.usage.generic">
        <title>Utilisation de base</title>

        <para>
            La manière la plus simple consiste à se reposer sur la locale de l'utilisateur. Lorsque vous créez
            une instance de <classname>Zend_Currency</classname> sans préciser d'options, la locale du client sera alors
            utilisée.
        </para>

        <example id="zend.currency.usage.generic.example-1">
            <title>Créer une monnaie avec les paramètres du client</title>

            <para>
                Imaginons un client dont la locale est "en_US" dans son navigateur. Dans ce cas,
                <classname>Zend_Currency</classname> détectera automatiquement la monnaie à utiliser.
            </para>

            <programlisting language="php"><![CDATA[
$currency = new Zend_Currency();

// Voyons les paramètres par défaut régis par la locale utilisateur
// var_dump($currency);
]]></programlisting>

            <para>
                L'objet crée va alors contenir une monnaie "US Dollar" car il s'agit de la monnaie affectée
                aux USA. D'autres options ont aussi été affectées comme le signe "$" ou l'abbréviation
                 "USD".
            </para>
        </example>

        <note>
            <title>La détection automatique par locale ne fonctionne pas toujours</title>

            <para>
                La détection automatique par locale ne fonctionne pas toujours car
                <classname>Zend_Currency</classname> nécessite une locale incluant la région. Si le client
                utilise une locale courte ("en"), <classname>Zend_Currency</classname> ne sait pas quelle
                région parmi les 30 possibles choisir. Une exception sera alors levée.
            </para>

            <para>
                Un client peut aussi déregler la locale dans son navigateur, ou la supprimer. Ainsi le paramètre
                de l'environnement sera alors utilisé pour la locale, ce qui peut mener à des comportements non
                attendus ou des exceptions.
            </para>
        </note>
    </sect2>

    <sect2 id="zend.currency.usage.locale">
        <title>Créer une monnaie basée sur une locale</title>

        <para>
            Pour éviter ce genre de problème, précisez manuellement la locale à utiliser.
        </para>

        <programlisting language="php"><![CDATA[
$currency = new Zend_Currency('en_US');

// Utilisation de l'option 'locale'
// $currency = new Zend_Currency(array('locale' => 'en_US'));

// Voir la monnaie avec les paramètres actuels fixés à 'en_US'
// var_dump($currency);
]]></programlisting>

        <para>
            Dans l'exemple ci-dessus, nous ne sommes plus dépendant du client.
        </para>

        <para>
            <classname>Zend_Currency</classname> supporte aussi l'utilisation d'une locale globale.
            Mettez une instance de <classname>Zend_Locale</classname> dans le registre comme montré
            ci-après. Dans un tel cas, l'option locale n'est plus obligatoire pour chaque instance
            et la même locale sera utilisée partout, tout le temps.
        </para>

        <programlisting language="php"><![CDATA[
// dans le bootstrap
$locale = new Zend_Locale('de_AT');
Zend_Registry::set('Zend_Locale', $locale);

// quelque part dans l'application
$currency = new Zend_Currency();
]]></programlisting>
    </sect2>
</sect1>