|
|
@@ -5,143 +5,146 @@
|
|
|
<title>Zend_Application_Resource_Locale</title>
|
|
|
|
|
|
<para>
|
|
|
- <classname>Zend_Application_Resource_Locale</classname> can be used to
|
|
|
- set an application-wide locale which is then used in all classes and components
|
|
|
- which work with localization or internationalization.
|
|
|
+ <classname>Zend_Application_Resource_Locale</classname> peut être utilisé pour paramétrer
|
|
|
+ de manière globale la région dans une application qui sera alors utilisée par toutes les
|
|
|
+ classes et les composants qui travaille avec la localisation et l'internationalisation.
|
|
|
</para>
|
|
|
|
|
|
<para>
|
|
|
- There are basically three usecases for the Locale Resource Plugin. Each of them
|
|
|
- should be used depending on the applications need.
|
|
|
+ Il y a basiquement trois cas d'utilisation du plugin de ressource Locale. Chacun pouvant
|
|
|
+ être utilisé suivant les besoins de votre application.
|
|
|
</para>
|
|
|
|
|
|
<sect3 id="zend.application.available-resources.locale.auto">
|
|
|
- <title>Autodetect the locale to use</title>
|
|
|
+ <title>Autodétection de la locale à utiliser</title>
|
|
|
|
|
|
<para>
|
|
|
- Without specifying any options for
|
|
|
+ Sans spécifier d'options pour
|
|
|
<classname>Zend_Application_Resource_Locale</classname>,
|
|
|
- <classname>Zend_Locale</classname> will detect the locale, which your application will
|
|
|
- use, automatically.
|
|
|
+ <classname>Zend_Locale</classname> va détecter automatiquement la locale, que votre
|
|
|
+ application va utiliser.
|
|
|
</para>
|
|
|
|
|
|
<para>
|
|
|
- This detection works because your client sends the wished language within his
|
|
|
- <acronym>HTTP</acronym> request. Normally the clients browser sends the languages he
|
|
|
- wants to see, and <classname>Zend_Locale</classname> uses this information for
|
|
|
- detection.
|
|
|
+ Cette détection fonctionne car votre client émet la langue souhaitée à l'intérieur
|
|
|
+ de sa requête <acronym>HTTP</acronym>. Normalement le navigateur client envoie
|
|
|
+ les langues qu'il accepte de voir, et <classname>Zend_Locale</classname> utilise
|
|
|
+ cette information pour la détection.
|
|
|
</para>
|
|
|
|
|
|
<para>
|
|
|
- But there are 2 problems with this approach:
|
|
|
+ Mais il y a deux problèmes avec cette approche :
|
|
|
</para>
|
|
|
|
|
|
<itemizedlist>
|
|
|
<listitem>
|
|
|
<para>
|
|
|
- The browser could be setup to send no language
|
|
|
+ Le navigateur pourrait ne paramétrer aucune langue
|
|
|
</para>
|
|
|
</listitem>
|
|
|
|
|
|
<listitem>
|
|
|
<para>
|
|
|
- The user could have manually set a locale which does not exist
|
|
|
+ L'utilisateur pourrait avoir manuellement paramétrer une locale qui n'existe pas
|
|
|
</para>
|
|
|
</listitem>
|
|
|
</itemizedlist>
|
|
|
|
|
|
<para>
|
|
|
- In both cases <classname>Zend_Locale</classname> will fallback to other mechanism to
|
|
|
- detect the locale:
|
|
|
+ Dans ces deux cas <classname>Zend_Locale</classname> reviendra vers d'autres
|
|
|
+ mécanismes pour détecter la locale :
|
|
|
</para>
|
|
|
|
|
|
<itemizedlist>
|
|
|
<listitem>
|
|
|
<para>
|
|
|
- When a locale has been set which does not exist,
|
|
|
- <classname>Zend_Locale</classname> tries to downgrade this string.
|
|
|
+ Quand une locale inexistante a été fournie, <classname>Zend_Locale</classname>
|
|
|
+ essaie de réduire la chaîne.
|
|
|
</para>
|
|
|
|
|
|
<para>
|
|
|
- When, for example, <emphasis>en_ZZ</emphasis> is set it will automatically
|
|
|
- be degraded to <emphasis>en</emphasis>. In this case <emphasis>en</emphasis>
|
|
|
- will be used as locale for your application.
|
|
|
+ Quand, par exemple, <emphasis>fr_ZZ</emphasis> a été paramétré, il est
|
|
|
+ automatiquement réduit en <emphasis>fr</emphasis>. Dans ce cas
|
|
|
+ <emphasis>fr</emphasis> sera utilisé en tant que locale pour votre application.
|
|
|
</para>
|
|
|
</listitem>
|
|
|
|
|
|
<listitem>
|
|
|
<para>
|
|
|
- When the locale could also not be detected by downgrading, the locale of your
|
|
|
- environment (web server) will be used. Most available environments from
|
|
|
- Web Hosters use <emphasis>en</emphasis> as locale.
|
|
|
+ Quand la locale ne peut pas non plus être reconnue même après réduction, la
|
|
|
+ locale de votre environnement (serveur Web) sera utilisée. La plupart des
|
|
|
+ environnements des hébergeurs utilise <emphasis>en</emphasis> en tant que
|
|
|
+ locale.
|
|
|
</para>
|
|
|
</listitem>
|
|
|
|
|
|
<listitem>
|
|
|
<para>
|
|
|
- When the systems locale could not be detected <classname>Zend_Locale</classname>
|
|
|
- will use it's default locale, which is set to <emphasis>en</emphasis> per
|
|
|
- default.
|
|
|
+ Quand la locale de l'environnement ne peut pas non plus être détectée,
|
|
|
+ <classname>Zend_Locale</classname> utilisera sa locale par défaut, qui
|
|
|
+ est par défaut <emphasis>en</emphasis>.
|
|
|
</para>
|
|
|
</listitem>
|
|
|
</itemizedlist>
|
|
|
|
|
|
<para>
|
|
|
- For more informations about locale detection take a look into <link
|
|
|
- linkend="zend.locale.selection.automatic">this chapter on Zend_Locale's automatic
|
|
|
- detection</link>.
|
|
|
+ Pour de plus amples informations concernant la détection des locales, lisez <link
|
|
|
+ linkend="zend.locale.selection.automatic">le chapitre sur la déctection automatique
|
|
|
+ avec Zend_Locale</link>.
|
|
|
</para>
|
|
|
</sect3>
|
|
|
|
|
|
<sect3 id="zend.application.available-resources.locale.fallback">
|
|
|
- <title>Autodetect the locale and adding a own fallback</title>
|
|
|
+ <title>Autodétection de la locale avec ajout de votre propre valeur par défaut</title>
|
|
|
|
|
|
<para>
|
|
|
- The above autodetection could lead to problems when the locale could not be detected and
|
|
|
- you want to have another default locale than <emphasis>en</emphasis>. To prevent this,
|
|
|
- <classname>Zend_Application_Resource_Locale</classname> allows you to set a own locale
|
|
|
- which will be used in the case that the locale could not be detected.
|
|
|
+ L'autodétection ci-dessus peut entraîner des problèmes quand la locale ne peut pas être
|
|
|
+ détectée et que vous souhaitez une autre locale par défaut que <emphasis>en</emphasis>.
|
|
|
+ Pour empêcher ceci, <classname>Zend_Application_Resource_Locale</classname> vous permet
|
|
|
+ de paramétrer votre propre locale qui sera utilisée si aucune locale ne peut être
|
|
|
+ détectée.
|
|
|
</para>
|
|
|
|
|
|
<example id="zend.application.available-resources.locale.configExampleDetectAndFallback">
|
|
|
- <title>Autodetect locale and setting a fallback</title>
|
|
|
+ <title>Autodétecter la locale et paramétrer une valeur par défaut</title>
|
|
|
|
|
|
<para>
|
|
|
- The following snippet shows how to set a own default locale which will be used when
|
|
|
- the client does not send a locale himself.
|
|
|
+ L'extrait suivant montre comment spécifier sa propre locale utilisée si le client
|
|
|
+ n'envoie pas lui-même une locale.
|
|
|
</para>
|
|
|
|
|
|
<programlisting language="ini"><![CDATA[
|
|
|
-; Try to determine automatically first,
|
|
|
-; if unsuccessful, use nl_NL as fallback.
|
|
|
-resources.locale.default = "nl_NL"
|
|
|
+; tentative de détection automaitque,
|
|
|
+; si impossible alors on prend fr_FR.
|
|
|
+resources.locale.default = "fr_FR"
|
|
|
]]></programlisting>
|
|
|
</example>
|
|
|
</sect3>
|
|
|
|
|
|
<sect3 id="zend.application.available-resources.locale.forcing">
|
|
|
- <title>Forcing a specific locale to use</title>
|
|
|
+ <title>Forcer l'utilisation d'une locale</title>
|
|
|
|
|
|
<para>
|
|
|
- Sometimes it is useful to define a single locale which has to be used. This can be done
|
|
|
- by using the <property>force</property> option.
|
|
|
+ Parfois il peut être pratique de définir la locale qui devra être utilisée. Ceci peut
|
|
|
+ être fait en utilisant l'option <property>force</property>.
|
|
|
</para>
|
|
|
|
|
|
<para>
|
|
|
- In this case this single locale will be used and the automatic detection is turned
|
|
|
- off.
|
|
|
+ Dasn ce cas, cette locale seule sera utilisée et la détection automatique sera
|
|
|
+ désactivée.
|
|
|
</para>
|
|
|
|
|
|
<example id="zend.application.available-resources.locale.configExampleFallbackOnly">
|
|
|
- <title>Defining a single locale to use</title>
|
|
|
+ <title>Définition de la locale à utiliser</title>
|
|
|
|
|
|
<para>
|
|
|
- The following snippet shows how to set a single locale for your entire application.
|
|
|
+ L'extrait suivant montre comment spécifier la locale à utiliser pour toute votre
|
|
|
+ application.
|
|
|
</para>
|
|
|
|
|
|
<programlisting language="ini"><![CDATA[
|
|
|
-; No matter what, the nl_NL locale will be used.
|
|
|
-resources.locale.default = "nl_NL"
|
|
|
+; dans tous les cas, fr_FR doit être utilisé
|
|
|
+resources.locale.default = "fr_FR"
|
|
|
resources.locale.force = true
|
|
|
]]></programlisting>
|
|
|
</example>
|