Prechádzať zdrojové kódy

[DOCUMENTATION] French:
- sync with English

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

mikaelkael 16 rokov pred
rodič
commit
37dbb1bb32

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

@@ -11,27 +11,27 @@
 
     <para>
         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>
         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
-        é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>
 
     <example id="zend.cache.introduction.example-1">
         <title>Créer un frontend avec Zend_Cache::factory()</title>
 
         <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>
 
         <programlisting language="php"><![CDATA[
@@ -57,7 +57,7 @@ $cache = Zend_Cache::factory('Core',
         <title>Frontends et Backends constitués de plusieurs mots</title>
         <para>
             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 (".").
         </para>
     </note>
@@ -68,9 +68,9 @@ $cache = Zend_Cache::factory('Core',
         <para>
             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
-            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>
 
         <programlisting language="php"><![CDATA[
@@ -103,15 +103,15 @@ print_r($result);
         <para>
             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
-            <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>
             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>
 
         <programlisting language="php"><![CDATA[
@@ -144,11 +144,11 @@ echo "Ceci n' jamais mis en cache (" . time() . ").";
 ]]></programlisting>
 
         <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
             expiré -- seulement pour être mis en cache de nouveau. Vous devriez essayer ce code
             dans votre navigateur ou dans une console.
@@ -159,7 +159,8 @@ echo "Ceci n' jamais mis en cache (" . time() . ").";
     <note>
         <para>
             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
             des caches en efface d'autres, ou encore pire, s'affiche en lieu et place d'autres.
         </para>

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

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 15617 -->
+<!-- EN-Revision: 16422 -->
 <!-- Reviewed: no -->
 <sect1 id="zend.cache.theory">
     <title>Aspect théorique</title>
@@ -7,23 +7,24 @@
     <para>
         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
-        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
-        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
-        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>
 
     <note>
         <para>
             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>
     </note>
 
@@ -70,13 +71,13 @@ $cache = Zend_Cache::factory($frontendName,
 
         <para>
             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.
         </para>
 
         <note>
             <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
                 fonctionnera pas comme prévu.
             </para>
@@ -88,10 +89,10 @@ $cache = Zend_Cache::factory($frontendName,
 
         <para>
             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>
 
         <programlisting language="php"><![CDATA[
@@ -102,10 +103,10 @@ $cache->save($grande_donnees,
 
         <note>
             <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>
         </note>
     </sect2>
@@ -114,8 +115,8 @@ $cache->save($grande_donnees,
         <title>Nettoyer le cache</title>
 
         <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>
 
         <programlisting language="php"><![CDATA[
@@ -123,9 +124,9 @@ $cache->remove('idAEffacer');
 ]]></programlisting>
 
         <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>
 
         <programlisting language="php"><![CDATA[
@@ -165,11 +166,11 @@ $cache->clean(Zend_Cache::CLEANING_MODE_MATCHING_ANY_TAG,
 ]]></programlisting>
 
         <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.
         </para>
     </sect2>