Browse Source

[DOCUMENTATION] French:
- sync with English

git-svn-id: http://framework.zend.com/svn/framework/standard/trunk@16423 44c647ce-9c0f-0410-b52a-842ac1e357ba

mikaelkael 16 years ago
parent
commit
37dbb1bb32

+ 26 - 25
documentation/manual/fr/module_specs/Zend_Cache-Introduction.xml

@@ -11,27 +11,27 @@
 
 
     <para>
     <para>
         Le cache dans Zend Framework est réalisé via les frontends alors que les caches
         Le cache dans Zend Framework est réalisé via les frontends alors que les caches
-        d'enregistrements sont stockés grâce à des adaptateurs de backend (<code>File</code>,
-        <code>Sqlite</code>, <code>Memcache</code>...) grâce à un système souple d'ID et de
-        balises. En les utilisant, il est simple de supprimer des types spécifiques
-        d'enregistrements par la suite (par exemple: "supprime tous les enregistrements de cache
-        marqués avec une balise donnée").
+        d'enregistrements sont stockés grâce à des adaptateurs de backend
+        (<emphasis>File</emphasis>, <emphasis>Sqlite</emphasis>, <emphasis>Memcache</emphasis>...)
+        grâce à un système souple d'ID et de balises. En les utilisant, il est simple de supprimer
+        des types spécifiques d'enregistrements par la suite (par exemple: "supprime tous les
+        enregistrements de cache marqués avec une balise donnée").
     </para>
     </para>
 
 
     <para>
     <para>
         Le coeur du module (<classname>Zend_Cache_Core</classname>) est générique, souple et
         Le coeur du module (<classname>Zend_Cache_Core</classname>) est générique, souple et
         configurable. Pour le moment, pour vos besoins spécifiques, il y a des frontends qui
         configurable. Pour le moment, pour vos besoins spécifiques, il y a des frontends qui
-        étendent <classname>Zend_Cache_Core</classname> simplement : <code>Output</code>,
-        <code>File</code>, <code>Function</code> et <code>Class</code>.
+        étendent <classname>Zend_Cache_Core</classname> simplement : <emphasis>Output</emphasis>,
+        <emphasis>File</emphasis>, <emphasis>Function</emphasis> et <emphasis>Class</emphasis>.
     </para>
     </para>
 
 
     <example id="zend.cache.introduction.example-1">
     <example id="zend.cache.introduction.example-1">
         <title>Créer un frontend avec Zend_Cache::factory()</title>
         <title>Créer un frontend avec Zend_Cache::factory()</title>
 
 
         <para>
         <para>
-            <classname>Zend_Cache::factory()</classname> instancie les objets corrects et les lie
-            ensemble. Dans le premier exemple, nous allons utiliser le frontend <code>Core</code>
-            avec le backend <code>File</code>.
+            <methodname>Zend_Cache::factory()</methodname> instancie les objets corrects et les lie
+            ensemble. Dans le premier exemple, nous allons utiliser le frontend
+            <emphasis>Core</emphasis> avec le backend <emphasis>File</emphasis>.
         </para>
         </para>
 
 
         <programlisting language="php"><![CDATA[
         <programlisting language="php"><![CDATA[
@@ -57,7 +57,7 @@ $cache = Zend_Cache::factory('Core',
         <title>Frontends et Backends constitués de plusieurs mots</title>
         <title>Frontends et Backends constitués de plusieurs mots</title>
         <para>
         <para>
             Certains frontends et backends sont nommés en utilisant plusieurs mots, comme
             Certains frontends et backends sont nommés en utilisant plusieurs mots, comme
-            "<code>ZendPlatform</code>". En les spécifiant à la fabrique, séparez les en utilisant
+            "ZendPlatform". En les spécifiant à la fabrique, séparez les en utilisant
             un séparateur de mot, comme l'espace (" "), le tiret ("-") ou le point (".").
             un séparateur de mot, comme l'espace (" "), le tiret ("-") ou le point (".").
         </para>
         </para>
     </note>
     </note>
@@ -68,9 +68,9 @@ $cache = Zend_Cache::factory('Core',
         <para>
         <para>
             Maintenant que nous avons un frontend, nous pouvons mettre en cache tout type de
             Maintenant que nous avons un frontend, nous pouvons mettre en cache tout type de
             données (nous avons activé la sérialisation). Par exemple nous pouvons mettre en cache
             données (nous avons activé la sérialisation). Par exemple nous pouvons mettre en cache
-            le résultat d'une requête SQL coûteuse. Après qu'il soit mis en cache, il n'y a plus
-            besoin de se connecter à la base de données. Les enregistrements récupérés depuis le
-            cache sont désérialisés.
+            le résultat d'une requête de base de données coûteuse. Après qu'il soit mis en cache,
+            il n'y a plus besoin de se connecter à la base de données. Les enregistrements récupérés
+            depuis le cache sont désérialisés.
         </para>
         </para>
 
 
         <programlisting language="php"><![CDATA[
         <programlisting language="php"><![CDATA[
@@ -103,15 +103,15 @@ print_r($result);
         <para>
         <para>
             Nous marquons les sections dans lesquelles nous voulons un cache de sortie en
             Nous marquons les sections dans lesquelles nous voulons un cache de sortie en
             ajoutant de la logique conditionnelle, en encapsulant la section entre les méthodes
             ajoutant de la logique conditionnelle, en encapsulant la section entre les méthodes
-            <code>start()</code> et <code>end()</code> (cela ressemble au premier exemple et est le
-            coeur de la stratégie de mise en cache).
+            <methodname>start()</methodname> et <methodname>end()</methodname>
+            (cela ressemble au premier exemple et est le coeur de la stratégie de mise en cache).
         </para>
         </para>
 
 
         <para>
         <para>
             A l'intérieur, affichez vos données comme d'habitude toutes les sorties seront
             A l'intérieur, affichez vos données comme d'habitude toutes les sorties seront
-            misent en cache quand la méthode <code>end()</code> est appelée. A la prochaine
-            exécution, la section complète sera évitée, au profit de la récupération de son cache
-            (si le cache est encore valide).
+            misent en cache quand la méthode <methodname>end()</methodname> est appelée. A la
+            prochaine exécution, la section complète sera évitée, au profit de la récupération de
+            son cache (si le cache est encore valide).
         </para>
         </para>
 
 
         <programlisting language="php"><![CDATA[
         <programlisting language="php"><![CDATA[
@@ -144,11 +144,11 @@ echo "Ceci n' jamais mis en cache (" . time() . ").";
 ]]></programlisting>
 ]]></programlisting>
 
 
         <para>
         <para>
-            Notez que nous affichons le résultat de <code>time()</code> deux fois&#160;; c'est
-            dans un but de démonstration. Essayez de lancer la page et de la rafraîchir plusieurs
-            fois&#160;; vous allez constater que le premier nombre ne change pas alors que le second
-            change à chaque actualisation. C'est parce que le premier nombre a été mis en cache et
-            sauvegardé. Après 30 secondes ("<code>lifeTime</code>" a été mis à 30 secondes), le
+            Notez que nous affichons le résultat de <methodname>time()</methodname> deux fois&#160;;
+            c'est dans un but de démonstration. Essayez de lancer la page et de la rafraîchir
+            plusieurs fois&#160;; vous allez constater que le premier nombre ne change pas alors
+            que le second change à chaque actualisation. C'est parce que le premier nombre a été
+            mis en cache et sauvegardé. Après 30 secondes ("lifeTime" a été mis à 30 secondes), le
             premier nombre devrait de nouveau correspondre au second nombre parce que le cache a
             premier nombre devrait de nouveau correspondre au second nombre parce que le cache a
             expiré -- seulement pour être mis en cache de nouveau. Vous devriez essayer ce code
             expiré -- seulement pour être mis en cache de nouveau. Vous devriez essayer ce code
             dans votre navigateur ou dans une console.
             dans votre navigateur ou dans une console.
@@ -159,7 +159,8 @@ echo "Ceci n' jamais mis en cache (" . time() . ").";
     <note>
     <note>
         <para>
         <para>
             Lorsque vous utilisez <classname>Zend_Cache</classname>, faîtes attention à
             Lorsque vous utilisez <classname>Zend_Cache</classname>, faîtes attention à
-            l'identifiant du cache (passé à <code>save()</code> et <code>start()</code>). Il doit
+            l'identifiant du cache (passé à <methodname>save()</methodname> et
+            <methodname>start()</methodname>). Il doit
             être unique pour chaque ressource que vous mettez en cache, sinon il est possible que
             être unique pour chaque ressource que vous mettez en cache, sinon il est possible que
             des caches en efface d'autres, ou encore pire, s'affiche en lieu et place d'autres.
             des caches en efface d'autres, ou encore pire, s'affiche en lieu et place d'autres.
         </para>
         </para>

+ 32 - 31
documentation/manual/fr/module_specs/Zend_Cache-Theory.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 15617 -->
+<!-- EN-Revision: 16422 -->
 <!-- Reviewed: no -->
 <!-- Reviewed: no -->
 <sect1 id="zend.cache.theory">
 <sect1 id="zend.cache.theory">
     <title>Aspect théorique</title>
     <title>Aspect théorique</title>
@@ -7,23 +7,24 @@
     <para>
     <para>
         Il y a trois concepts clés dans <classname>Zend_Cache</classname>. Le premier est
         Il y a trois concepts clés dans <classname>Zend_Cache</classname>. Le premier est
         l'identifiant unique (une chaîne) qui est utilisé pour identifier les enregistrements de
         l'identifiant unique (une chaîne) qui est utilisé pour identifier les enregistrements de
-        cache. Le second est la directive <code>"lifeTime"</code> vue dans les exemples&#160;; elle
-        définit combien de temps la ressource de cache est considérée comme à jour. Le troisième
-        est l'exécution conditionnelle, ainsi chaque partie de votre code peut être évitée
-        entièrement, pour améliorer les performances. La fonction principale du frontend
-        (<classname>Zend_Cache_Core::get()</classname>) est toujours faite pour retourner
-        <code>false</code> en cas de cache manquant, si cela donne du sens à la nature d'un
+        cache. Le second est la directive <emphasis>"lifeTime"</emphasis> vue dans les
+        exemples&#160;; elle définit combien de temps la ressource de cache est considérée comme à
+        jour. Le troisième est l'exécution conditionnelle, ainsi chaque partie de votre code peut
+        être évitée entièrement, pour améliorer methodname performances. La fonction principale du
+        frontend (<methodname>Zend_Cache_Core::get()</methodname>) est toujours faite pour retourner
+        <constant>FALSE</constant> en cas de cache manquant, si cela donne du sens à la nature d'un
         frontend. Cela permet aux utilisateurs d'entourer des parties de code qu'ils veulent mettre
         frontend. Cela permet aux utilisateurs d'entourer des parties de code qu'ils veulent mettre
-        en cache (et éviter) dans une instruction <code>if(){ ... }</code> où la condition est une
+        en cache (et éviter) dans une instruction
+        <emphasis><methodname>if()</methodname>{ ... }</emphasis> où la condition est une
         méthode <classname>Zend_Cache</classname>. A la fin de ces blocs, vous devez sauvegarder ce
         méthode <classname>Zend_Cache</classname>. A la fin de ces blocs, vous devez sauvegarder ce
-        que vous avez généré (par exemple <classname>Zend_Cache_Core::save()</classname>).
+        que vous avez généré (par exemple <methodname>Zend_Cache_Core::save()</methodname>).
     </para>
     </para>
 
 
     <note>
     <note>
         <para>
         <para>
             Le design de l'exécution conditionnelle de votre code généré n'est pas forcément
             Le design de l'exécution conditionnelle de votre code généré n'est pas forcément
-            dans des frontends (<code>Function</code>, par exemple) quand toute la logique est
-            implémentée à l'intérieur du frontend.
+            dans des frontends (<emphasis>Function</emphasis>, par exemple) quand toute la logique
+            est implémentée à l'intérieur du frontend.
         </para>
         </para>
     </note>
     </note>
 
 
@@ -70,13 +71,13 @@ $cache = Zend_Cache::factory($frontendName,
 
 
         <para>
         <para>
             Dans les exemples suivants, nous nous assurerons que la variable
             Dans les exemples suivants, nous nous assurerons que la variable
-            <code>$cache</code> utilise une instance de frontend valide, et que vous
+            <varname>$cache</varname> utilise une instance de frontend valide, et que vous
             comprenez comment passer des paramètres à vos backends.
             comprenez comment passer des paramètres à vos backends.
         </para>
         </para>
 
 
         <note>
         <note>
             <para>
             <para>
-                Utilisez toujours <classname>Zend_Cache::factory()</classname> pour obtenir des
+                Utilisez toujours <methodname>Zend_Cache::factory()</methodname> pour obtenir des
                 instances de frontend. Instancier des frontends et des backends par vous-même ne
                 instances de frontend. Instancier des frontends et des backends par vous-même ne
                 fonctionnera pas comme prévu.
                 fonctionnera pas comme prévu.
             </para>
             </para>
@@ -88,10 +89,10 @@ $cache = Zend_Cache::factory($frontendName,
 
 
         <para>
         <para>
             Les balises sont un moyen de catégoriser les enregistrements de cache. Quand vous
             Les balises sont un moyen de catégoriser les enregistrements de cache. Quand vous
-            sauvegardez un cache avec la méthode <code>save()</code> vous pouvez définir un tableau
-            de balises qui s'appliqueront à cet enregistrement. Ensuite vous serez en mesure de
-            nettoyer tous les enregistrements de cache identifiés par une balise (ou plusieurs)
-            donnée&#160;:
+            sauvegardez un cache avec la méthode <methodname>save()</methodname> vous pouvez
+            définir un tableau de balises qui s'appliqueront à cet enregistrement. Ensuite vous
+            serez en mesure de nettoyer tous les enregistrements de cache identifiés par
+            une balise (ou plusieurs) donnée&#160;:
         </para>
         </para>
 
 
         <programlisting language="php"><![CDATA[
         <programlisting language="php"><![CDATA[
@@ -102,10 +103,10 @@ $cache->save($grande_donnees,
 
 
         <note>
         <note>
             <para>
             <para>
-                Notez que la méthode <code>save()</code> accepte un quatrième paramètre
-                optionnel : <code>$specificLifetime</code> (si différent de <code>false</code>, il
-                affecte un '<code>lifeTime</code>' spécifique pour cet enregistrement de cache
-                particulier).
+                Notez que la méthode <methodname>save()</methodname> accepte un quatrième paramètre
+                optionnel : <varname>$specificLifetime</varname> (si différent de
+                <constant>FALSE</constant>, il affecte un "lifeTime" spécifique pour
+                cet enregistrement de cache particulier).
             </para>
             </para>
         </note>
         </note>
     </sect2>
     </sect2>
@@ -114,8 +115,8 @@ $cache->save($grande_donnees,
         <title>Nettoyer le cache</title>
         <title>Nettoyer le cache</title>
 
 
         <para>
         <para>
-            Pour supprimer/invalider un identifiant de cache particulier, vous pouvez
-            utiliser la méthode <code>remove()</code>&#160;:
+            Pour supprimer&#160;/&#160;invalider un identifiant de cache particulier, vous pouvez
+            utiliser la méthode <methodname>remove()</methodname>&#160;:
         </para>
         </para>
 
 
         <programlisting language="php"><![CDATA[
         <programlisting language="php"><![CDATA[
@@ -123,9 +124,9 @@ $cache->remove('idAEffacer');
 ]]></programlisting>
 ]]></programlisting>
 
 
         <para>
         <para>
-            Pour effacer/invalider plusieurs identifiants de caches en une seule opération,
-            vous pouvez utiliser la méthode <code>clean()</code>. Par exemple, pour supprimer tous
-            les caches&#160;:
+            Pour effacer&#160;/&#160;invalider plusieurs identifiants de caches en une seule
+            opération, vous pouvez utiliser la méthode <methodname>clean()</methodname>. Par
+            exemple, pour supprimer tous les caches&#160;:
         </para>
         </para>
 
 
         <programlisting language="php"><![CDATA[
         <programlisting language="php"><![CDATA[
@@ -165,11 +166,11 @@ $cache->clean(Zend_Cache::CLEANING_MODE_MATCHING_ANY_TAG,
 ]]></programlisting>
 ]]></programlisting>
 
 
         <para>
         <para>
-            Les modes disponibles de nettoyage sont <code>CLEANING_MODE_ALL</code>,
-            <code>CLEANING_MODE_OLD</code>, <code>CLEANING_MODE_MATCHING_TAG</code>,
-            <code>CLEANING_MODE_NOT_MATCHING_TAG</code> et
-            <code>CLEANING_MODE_MATCHING_ANY_TAG</code>. Les derniers, comme leur nom l'indique,
-            sont à combiner avec un tableau de balises pour réaliser les opérations de
+            Les modes disponibles de nettoyage sont <constant>CLEANING_MODE_ALL</constant>,
+            <constant>CLEANING_MODE_OLD</constant>, <constant>CLEANING_MODE_MATCHING_TAG</constant>,
+            <constant>CLEANING_MODE_NOT_MATCHING_TAG</constant> et
+            <constant>CLEANING_MODE_MATCHING_ANY_TAG</constant>. Les derniers, comme leur nom
+            l'indique, sont à combiner avec un tableau de balises pour réaliser les opérations de
             nettoyage.
             nettoyage.
         </para>
         </para>
     </sect2>
     </sect2>