Sfoglia il codice sorgente

DOCUMENTATION French: sync and clean manual

git-svn-id: http://framework.zend.com/svn/framework/standard/trunk@15408 44c647ce-9c0f-0410-b52a-842ac1e357ba
mikaelkael 16 anni fa
parent
commit
52bd4da0c9

File diff suppressed because it is too large
+ 459 - 256
documentation/manual/fr/module_specs/Zend_Db_Adapter.xml


+ 27 - 15
documentation/manual/fr/module_specs/Zend_Db_Profiler-Firebug.xml

@@ -1,36 +1,48 @@
-<?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 13846 -->
+<?xml version="1.0" encoding="UTF-8"?>
+<!-- EN-Revision: 15207 -->
 <!-- Reviewed: no -->
 <sect3 id="zend.db.profiler.profilers.firebug">
     <title>Profiler avec Firebug</title>
 
-    <para><classname>Zend_Db_Profiler_Firebug</classname> envoie des informations de profilage vers la <ulink
-    url="http://www.getfirebug.com/">console Firebug</ulink>.</para>
+    <para>
+        <classname>Zend_Db_Profiler_Firebug</classname> envoie des informations de profilage
+        vers la <ulink url="http://www.getfirebug.com/">console Firebug</ulink>.
+    </para>
 
-    <para>Toutes les données sont envoyées via le composant <classname>Zend_Wildfire_Channel_HttpHeaders</classname> qui utilise
-    les en-têtes HTTP pour s'assurer que le contenu de la page n'est pas perturbé. Déboguer les requêtes AJAX qui
-    requière du JSON "propre" ou un réponse XML est possible avec cette approche.</para>
+    <para>
+        Toutes les données sont envoyées via le composant
+        <classname>Zend_Wildfire_Channel_HttpHeaders</classname> qui utilise les en-têtes HTTP pour
+        s'assurer que le contenu de la page n'est pas perturbé. Déboguer les requêtes AJAX qui
+        requière du JSON "propre" ou un réponse XML est possible avec cette approche.
+    </para>
 
-    <para>Éléments requis :</para>
+    <para>Éléments requis&#160;:</para>
 
     <itemizedlist>
         <listitem>
-            <para>Navigateur Firefox idéalement en version 3 mais la version 2 est aussi supportée.</para>
+            <para>
+                Navigateur Firefox idéalement en version 3 mais la version 2 est aussi
+                supportée.
+            </para>
         </listitem>
 
         <listitem>
-            <para>L'extension Firefox nommée Firebug qui peut être téléchargée à cette adresse <ulink
-            url="https://addons.mozilla.org/en-US/firefox/addon/1843">https://addons.mozilla.org/en-US/firefox/addon/1843</ulink>.</para>
+            <para>
+                L'extension Firefox nommée Firebug qui peut être téléchargée à cette adresse
+                <ulink url="https://addons.mozilla.org/en-US/firefox/addon/1843">https://addons.mozilla.org/en-US/firefox/addon/1843</ulink>.
+            </para>
         </listitem>
 
         <listitem>
-            <para>L'extension Firefox nommée FirePHP qui peut être téléchargée à cette adresse <ulink
-            url="https://addons.mozilla.org/en-US/firefox/addon/6149">https://addons.mozilla.org/en-US/firefox/addon/6149</ulink>.</para>
+            <para>
+                L'extension Firefox nommée FirePHP qui peut être téléchargée à cette adresse
+                <ulink url="https://addons.mozilla.org/en-US/firefox/addon/6149">https://addons.mozilla.org/en-US/firefox/addon/6149</ulink>.
+            </para>
         </listitem>
     </itemizedlist>
 
     <example id="zend.db.profiler.profilers.firebug.example.with_front_controller">
-        <title>Profilage de base de données avec <classname>Zend_Controller_Front</classname></title>
+        <title>Profilage de base de données avec Zend_Controller_Front</title>
 
         <programlisting role="php"><![CDATA[
 // Dans votre fichier d'amorçage
@@ -48,7 +60,7 @@ $db->setProfiler($profiler)
     </example>
 
     <example id="zend.db.profiler.profilers.firebug.example.without_front_controller">
-        <title>Profilage de base de données sans <classname>Zend_Controller_Front</classname></title>
+        <title>Profilage de base de données sans Zend_Controller_Front</title>
 
         <programlisting role="php"><![CDATA[
 $profiler = new Zend_Db_Profiler_Firebug('All DB Queries');

+ 185 - 98
documentation/manual/fr/module_specs/Zend_Db_Profiler.xml

@@ -1,5 +1,5 @@
-<?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 13846 -->
+<?xml version="1.0" encoding="UTF-8"?>
+<!-- EN-Revision: 15156 -->
 <!-- Reviewed: no -->
 <sect1 id="zend.db.profiler" xmlns:xi="http://www.w3.org/2001/XInclude">
     <title>Zend_Db_Profiler</title>
@@ -7,13 +7,19 @@
     <sect2 id="zend.db.profiler.introduction">
         <title>Introduction</title>
 
-        <para><classname>Zend_Db_Profiler</classname> peut être activé pour permettre le profilage de requête. Les profils
-        incluent les requêtes exécutées par l'adaptateur, ainsi que leur temps d'exécution, permettant l'inspection des
-        requêtes qui ont été exécutées sans avoir besoin de rajouter le code spécifique de débogage aux classes.
-        L'utilisation avancée permet aussi au développeur de filtrer quelles requêtes il souhaite profiler.</para>
+        <para>
+            <classname>Zend_Db_Profiler</classname> peut être activé pour permettre le
+            profilage de requête. Les profils incluent les requêtes exécutées par l'adaptateur,
+            ainsi que leur temps d'exécution, permettant l'inspection des requêtes qui ont été
+            exécutées sans avoir besoin de rajouter le code spécifique de débogage aux classes.
+            L'utilisation avancée permet aussi au développeur de filtrer quelles requêtes il
+            souhaite profiler.
+        </para>
 
-        <para>Le profileur s'active soit en passant une directive au constructeur de l'adaptateur, soit en spécifiant à
-        l'adaptateur de l'activer plus tard.</para>
+        <para>
+            Le profileur s'active soit en passant une directive au constructeur de
+            l'adaptateur, soit en spécifiant à l'adaptateur de l'activer plus tard.
+        </para>
 
         <programlisting role="php"><![CDATA[
 $params = array(
@@ -35,53 +41,69 @@ $db->getProfiler()->setEnabled(false);
 $db->getProfiler()->setEnabled(true);
 ]]></programlisting>
 
-        <para>La valeur de l'option <code>profiler</code> est souple. Elle est interprétée différemment suivant son
-        type. La plupart du temps, vous devriez simplement utiliser une variable booléenne, mais d'autres valeurs vous
-        permettent de personnaliser le comportement du profileur.</para>
-
-        <para>Un argument booléen active le profileur si c'est une valeur <code>true</code>, ou le désactive si
-        <code>false</code>. La classe de profileur est celle par défaut, par exemple <classname>Zend_Db_Profiler</classname>.
-        <programlisting role="php"><![CDATA[
+        <para>
+            La valeur de l'option <code>profiler</code> est souple. Elle est interprétée
+            différemment suivant son type. La plupart du temps, vous devriez simplement utiliser une
+            variable booléenne, mais d'autres valeurs vous permettent de personnaliser le
+            comportement du profileur.
+        </para>
+
+        <para>
+            Un argument booléen active le profileur si c'est une valeur <code>true</code>, ou
+            le désactive si <code>false</code>. La classe de profileur est celle par défaut, par
+            exemple <classname>Zend_Db_Profiler</classname>. <programlisting role="php"><![CDATA[
 $params['profiler'] = true;
 $db = Zend_Db::factory('PDO_MYSQL', $params);
-]]></programlisting></para>
+]]></programlisting>
+        </para>
 
-        <para>Une instance d'un objet profileur fait que l'adaptateur utilise cet objet. L'objet doit être de type
-        <classname>Zend_Db_Profiler</classname> ou une sous-classe. L'activation du profileur est faite séparément.
-        <programlisting role="php"><![CDATA[
+        <para>
+            Une instance d'un objet profileur fait que l'adaptateur utilise cet objet. L'objet
+            doit être de type <classname>Zend_Db_Profiler</classname> ou une sous-classe.
+            L'activation du profileur est faite séparément. <programlisting role="php"><![CDATA[
 $profiler = Mon_Db_Profiler();
 $profiler->setEnabled(true);
 $params['profiler'] = $profiler;
 $db = Zend_Db::factory('PDO_MYSQL', $params);
-]]></programlisting></para>
-
-        <para>L'argument peut être un tableau associatif contenant une ou toutes les clés suivantes :
-        "<code>enabled</code>", "<code>instance</code>", et "<code>class</code>". Les clés "<code>enabled</code>" et
-        "<code>instance</code>" correspondent aux types booléen et instance décrites ci-dessus. La clé
-        "<code>class</code>" est utilisée pour nommer une classe à prendre en tant que profileur personnalisé. La classe
-        doit être de type <classname>Zend_Db_Profiler</classname> ou une sous-classe. La classe est instanciée sans aucun argument
-        de constructeur. L'option "<code>class</code>" est ignorée quand l'option "<code>instance</code>" est fournie.
-        <programlisting role="php"><![CDATA[
+]]></programlisting>
+        </para>
+
+        <para>
+            L'argument peut être un tableau associatif contenant une ou toutes les clés
+            suivantes : "<code>enabled</code>", "<code>instance</code>", et "<code>class</code>".
+            Les clés "<code>enabled</code>" et "<code>instance</code>" correspondent aux types
+            booléen et instance décrites ci-dessus. La clé "<code>class</code>" est utilisée pour
+            nommer une classe à prendre en tant que profileur personnalisé. La classe doit être de
+            type <classname>Zend_Db_Profiler</classname> ou une sous-classe. La classe est
+            instanciée sans aucun argument de constructeur. L'option "<code>class</code>" est
+            ignorée quand l'option "<code>instance</code>" est fournie. <programlisting
+            role="php"><![CDATA[
 $params['profiler'] = array(
     'enabled' => true,
     'class'   => 'Mon_Db_Profiler'
 );
 $db = Zend_Db::factory('PDO_MYSQL', $params);
-]]></programlisting></para>
-
-        <para>Enfin, l'argument peut être un objet de type <classname>Zend_Config</classname> contenant des propriétés, qui sont
-        traitées comme les clés de tableaux décrites ci-dessus. Par exemple, une fichier "config.ini" peut contenir les
-        données suivantes : <programlisting role="ini"><![CDATA[
+]]></programlisting>
+        </para>
+
+        <para>
+            Enfin, l'argument peut être un objet de type <classname>Zend_Config</classname>
+            contenant des propriétés, qui sont traitées comme les clés de tableaux décrites
+            ci-dessus. Par exemple, une fichier "config.ini" peut contenir les données
+            suivantes&#160;:
+            <programlisting role="ini"><![CDATA[
 [main]
 db.profiler.class   = "Mon_Db_Profiler"
 db.profiler.enabled = true
-]]></programlisting> Cette configuration peut être appliquée par le code PHP suivant : <programlisting
-        role="php"><![CDATA[
+]]></programlisting>
+            Cette configuration peut être appliquée par le code PHP suivant&#160;:
+            <programlisting role="php"><![CDATA[
 $config = new Zend_Config_Ini('config.ini', 'main');
 $params['profiler'] = $config->db->profiler;
 $db = Zend_Db::factory('PDO_MYSQL', $params);
-]]></programlisting> La propriété "<code>instance</code>" peut être utilisée comme ceci : <programlisting
-        role="php"><![CDATA[
+]]></programlisting>
+            La propriété "<code>instance</code>" peut être utilisée comme ceci&#160;:
+            <programlisting role="php"><![CDATA[
 $profiler = new Mon_Db_Profiler();
 $profiler->setEnabled(true);
 $configData = array(
@@ -90,40 +112,56 @@ $configData = array(
 $config = new Zend_Config($configData);
 $params['profiler'] = $config;
 $db = Zend_Db::factory('PDO_MYSQL', $params);
-]]></programlisting></para>
+]]></programlisting>
+        </para>
     </sect2>
 
     <sect2 id="zend.db.profiler.using">
         <title>Utiliser le profileur</title>
 
-        <para>A n'importe quel moment, vous pouvez récupérer le profileur en utilisant la méthode
-        <code>getProfiler()</code> de l'adaptateur :</para>
+        <para>
+            A n'importe quel moment, vous pouvez récupérer le profileur en utilisant la
+            méthode <code>getProfiler()</code> de l'adaptateur&#160;:
+        </para>
 
         <programlisting role="php"><![CDATA[
 $profileur = $db->getProfiler();
 ]]></programlisting>
 
-        <para>Ceci retourne une instance de <classname>Zend_Db_Profiler</classname>. Avec cette instance, le développeur peut
-        examiner les requêtes en utilisant un éventail de méthodes :</para>
+        <para>
+            Ceci retourne une instance de <classname>Zend_Db_Profiler</classname>. Avec cette
+            instance, le développeur peut examiner les requêtes en utilisant un éventail de
+            méthodes&#160;:
+        </para>
 
         <itemizedlist>
             <listitem>
-                <para><code>getTotalNumQueries()</code> retourne le nombre total de requêtes profilées.</para>
+                <para>
+                    <code>getTotalNumQueries()</code> retourne le nombre total de requêtes
+                    profilées.
+                </para>
             </listitem>
 
             <listitem>
-                <para><code>getTotalElapsedSecs()</code> retourne le nombre total de secondes écoulées pour chaque
-                requête profilée.</para>
+                <para>
+                    <code>getTotalElapsedSecs()</code> retourne le nombre total de secondes
+                    écoulées pour chaque requête profilée.
+                </para>
             </listitem>
 
             <listitem>
-                <para><code>getQueryProfiles()</code> retourne un tableau de tous les profils de requêtes.</para>
+                <para>
+                    <code>getQueryProfiles()</code> retourne un tableau de tous les profils de
+                    requêtes.
+                </para>
             </listitem>
 
             <listitem>
-                <para><code>getLastQueryProfile()</code> retourne le profil de requête le plus récent, peut importe si
-                la requête à fini de s'exécuter ou pas (si l'exécution n'est pas finie, le temps de fin sera
-                <code>null</code>).</para>
+                <para>
+                    <code>getLastQueryProfile()</code> retourne le profil de requête le plus
+                    récent, peut importe si la requête à fini de s'exécuter ou pas (si l'exécution
+                    n'est pas finie, le temps de fin sera <code>null</code>).
+                </para>
             </listitem>
 
             <listitem>
@@ -131,41 +169,59 @@ $profileur = $db->getProfiler();
             </listitem>
         </itemizedlist>
 
-        <para>La valeur de retour de <code>getLastQueryProfile()</code> et les éléments individuels de
-        <code>getQueryProfiles()</code> sont des objets de type <classname>Zend_Db_Profiler_Query</classname> qui permettent
-        d'inspecter les requêtes :</para>
+        <para>
+            La valeur de retour de <code>getLastQueryProfile()</code> et les éléments
+            individuels de <code>getQueryProfiles()</code> sont des objets de type
+            <classname>Zend_Db_Profiler_Query</classname> qui permettent d'inspecter les
+            requêtes&#160;:
+        </para>
 
         <itemizedlist>
             <listitem>
-                <para><code>getQuery()</code> retourne le SQL de la requête sous forme de texte. Le texte de SQL d'une
-                requête préparée avec des paramètres est le texte au moment où la requête a été préparée, donc il
-                contient les emplacements de paramètre, mais pas les valeurs utilisées quand la déclaration est
-                exécutée.</para>
+                <para>
+                    <code>getQuery()</code> retourne le SQL de la requête sous forme de texte.
+                    Le texte de SQL d'une requête préparée avec des paramètres est le texte au
+                    moment où la requête a été préparée, donc il contient les emplacements de
+                    paramètre, mais pas les valeurs utilisées quand la déclaration est
+                    exécutée.
+                </para>
             </listitem>
 
             <listitem>
-                <para><code>getQueryParams()</code> retourne un tableau des valeurs de paramètres utilisées lors de
-                l'exécution d'une requête préparée. Ceci inclue à la fois les paramètres attachés et les arguments de de
-                la méthode <code>execute()</code>. Les clés du tableau sont les positions (base 1) ou les noms des
-                paramètres.</para>
+                <para>
+                    <code>getQueryParams()</code> retourne un tableau des valeurs de
+                    paramètres utilisées lors de l'exécution d'une requête préparée. Ceci inclue à
+                    la fois les paramètres attachés et les arguments de de la méthode
+                    <code>execute()</code>. Les clés du tableau sont les positions (base 1) ou les
+                    noms des paramètres.
+                </para>
             </listitem>
 
             <listitem>
-                <para><code>getElapsedSecs()</code> retourne le nombre de secondes d'exécution de la requête.</para>
+                <para>
+                    <code>getElapsedSecs()</code> retourne le nombre de secondes d'exécution
+                    de la requête.
+                </para>
             </listitem>
         </itemizedlist>
 
-        <para>L'information que <classname>Zend_Db_Profiler</classname> fourni est utile pour profiler des goulots d'étranglement
-        dans les applications, ainsi que pour déboguer les requêtes qui viennent d'être exécutées. Par exemple, pour
-        voir la dernière requête qui vient de s'exécuter :</para>
+        <para>
+            L'information que <classname>Zend_Db_Profiler</classname> fourni est utile pour
+            profiler des goulots d'étranglement dans les applications, ainsi que pour déboguer les
+            requêtes qui viennent d'être exécutées. Par exemple, pour voir la dernière requête qui
+            vient de s'exécuter&#160;:
+        </para>
 
         <programlisting role="php"><![CDATA[
 $query = $profileur->getLastQueryProfile();
 echo $query->getQuery();
 ]]></programlisting>
 
-        <para>Si une page se génère lentement, utilisez le profileur pour déterminer le nombre total de requêtes, et
-        ensuite passer d'une requête à l'autre pour voir laquelle a été la plus longue:</para>
+        <para>
+            Si une page se génère lentement, utilisez le profileur pour déterminer le nombre
+            total de requêtes, et ensuite passer d'une requête à l'autre pour voir laquelle a été la
+            plus longue&#160;:
+        </para>
 
         <programlisting role="php"><![CDATA[
 $tempsTotal       = $profileur->getTotalElapsedSecs();
@@ -201,16 +257,20 @@ echo "Requête la plus lente (SQL) : \n"
     <sect2 id="zend.db.profiler.advanced">
         <title>Utilisation avancée du profileur</title>
 
-        <para>En plus de l'inspection de requête, le profileur permet aussi au développeur de filtrer quelles requêtes
-        il veut profiler. Les méthodes suivantes fonctionnent avec une instance de <classname>Zend_Db_Profiler</classname>
-        :</para>
+        <para>
+            En plus de l'inspection de requête, le profileur permet aussi au développeur de
+            filtrer quelles requêtes il veut profiler. Les méthodes suivantes fonctionnent avec une
+            instance de <classname>Zend_Db_Profiler</classname>&#160;:
+        </para>
 
         <sect3 id="zend.db.profiler.advanced.filtertime">
             <title>Filtrer par temps d'exécution</title>
 
-            <para><code>setFilterElapsedSecs()</code> permet au développeur de définir un temps minimum d'exécution de
-            la requête avant que celle-ci soit profilée. Pour retirer le filtre, passez une valeur <code>null</code> à
-            la méthode.</para>
+            <para>
+                <code>setFilterElapsedSecs()</code> permet au développeur de définir un temps
+                minimum d'exécution de la requête avant que celle-ci soit profilée. Pour retirer le
+                filtre, passez une valeur <code>null</code> à la méthode.
+            </para>
 
             <programlisting role="php"><![CDATA[
 // Seules les requêtes qui durent au moins 5 secondes sont profilées :
@@ -224,49 +284,69 @@ $profileur->setFilterElapsedSecs(null);
         <sect3 id="zend.db.profiler.advanced.filtertype">
             <title>Filtrer par type de requête</title>
 
-            <para><code>setFilterQueryType()</code> permet au développeur de définir quels types de requêtes doivent
-            être profilées ; pour profiler des types multiples vous pouvez utiliser le OU logique. Les types de requêtes
-            sont définis sous forme de constantes de <classname>Zend_Db_Profiler</classname> :</para>
+            <para>
+                <code>setFilterQueryType()</code> permet au développeur de définir quels types
+                de requêtes doivent être profilées ; pour profiler des types multiples vous pouvez
+                utiliser le OU logique. Les types de requêtes sont définis sous forme de constantes
+                de <classname>Zend_Db_Profiler</classname>&#160;:
+            </para>
 
             <itemizedlist>
                 <listitem>
-                    <para><classname>Zend_Db_Profiler::CONNECT</classname> : opérations de connexion ou de sélection de base de
-                    données.</para>
+                    <para>
+                        <classname>Zend_Db_Profiler::CONNECT</classname>&#160;: opérations de
+                        connexion ou de sélection de base de données.
+                    </para>
                 </listitem>
 
                 <listitem>
-                    <para><classname>Zend_Db_Profiler::QUERY</classname> : requête générale qui ne correspond pas aux autres
-                    types.</para>
+                    <para>
+                        <classname>Zend_Db_Profiler::QUERY</classname>&#160;: requête générale qui
+                        ne correspond pas aux autres types.
+                    </para>
                 </listitem>
 
                 <listitem>
-                    <para><classname>Zend_Db_Profiler::INSERT</classname> : toute requête qui ajoute des données dans la base de
-                    données, généralement INSERT.</para>
+                    <para>
+                        <classname>Zend_Db_Profiler::INSERT</classname>&#160;: toute requête qui
+                        ajoute des données dans la base de données, généralement INSERT.
+                    </para>
                 </listitem>
 
                 <listitem>
-                    <para><classname>Zend_Db_Profiler::UPDATE</classname> : toute requête qui met à jour des données, généralement
-                    UPDATE.</para>
+                    <para>
+                        <classname>Zend_Db_Profiler::UPDATE</classname>&#160;: toute requête qui
+                        met à jour des données, généralement UPDATE.
+                    </para>
                 </listitem>
 
                 <listitem>
-                    <para><classname>Zend_Db_Profiler::DELETE</classname> : toute requête qui efface des données, généralement
-                    DELETE.</para>
+                    <para>
+                        <classname>Zend_Db_Profiler::DELETE</classname>&#160;: toute requête qui
+                        efface des données, généralement DELETE.
+                    </para>
                 </listitem>
 
                 <listitem>
-                    <para><classname>Zend_Db_Profiler::SELECT</classname> : toute requête qui récupère des données, généralement
-                    SELECT.</para>
+                    <para>
+                        <classname>Zend_Db_Profiler::SELECT</classname>&#160;: toute requête qui
+                        récupère des données, généralement SELECT.
+                    </para>
                 </listitem>
 
                 <listitem>
-                    <para><classname>Zend_Db_Profiler::TRANSACTION</classname> : toute requête qui concerne des opérations de
-                    transaction, comme start transaction, commit, ou rollback.</para>
+                    <para>
+                        <classname>Zend_Db_Profiler::TRANSACTION</classname>&#160;: toute requête
+                        qui concerne des opérations de transaction, comme start transaction, commit,
+                        ou rollback.
+                    </para>
                 </listitem>
             </itemizedlist>
 
-            <para>Comme avec <code>setFilterElapsedSecs()</code>, vous pouvez retirer tous les filtres en passant
-            <code>null</code> comme unique argument.</para>
+            <para>
+                Comme avec <code>setFilterElapsedSecs()</code>, vous pouvez retirer tous les
+                filtres en passant <code>null</code> comme unique argument.
+            </para>
 
             <programlisting role="php"><![CDATA[
 // profile uniquement les requêtes SELECT
@@ -288,11 +368,15 @@ $profileur->setFilterQueryType(null);
         <sect3 id="zend.db.profiler.advanced.getbytype">
             <title>Récupérer les profils par type de requête</title>
 
-            <para>Utiliser <code>setFilterQueryType()</code> peut réduire les profils générés. Cependant il est parfois
-            utile de garder tous les profils et voir uniquement ceux dont on a besoin, à un moment donné. Une autre
-            possibilité de <code>getQueryProfiles()</code> est qu'il est possible de filtrer à la volée, en passant un
-            type de requête (ou une combinaison logique de types de requête) comme premier argument ; voir <xref
-            linkend="zend.db.profiler.advanced.filtertype" /> pour la liste des constantes de types de requête.</para>
+            <para>
+                Utiliser <code>setFilterQueryType()</code> peut réduire les profils générés.
+                Cependant il est parfois utile de garder tous les profils et voir uniquement ceux
+                dont on a besoin, à un moment donné. Une autre possibilité de
+                <code>getQueryProfiles()</code> est qu'il est possible de filtrer à la volée, en
+                passant un type de requête (ou une combinaison logique de types de requête) comme
+                premier argument ; voir <xref linkend="zend.db.profiler.advanced.filtertype" /> pour
+                la liste des constantes de types de requête.
+            </para>
 
             <programlisting role="php"><![CDATA[
 // Récupère uniquement les profils des requêtes SELECT
@@ -314,8 +398,11 @@ $profiles = $profiler->getQueryProfiles(Zend_Db_Profiler::DELETE);
     <sect2 id="zend.db.profiler.profilers">
         <title>Profileurs spécialisés</title>
 
-        <para>Un profileur spécialisé est un objet qui hérite de <classname>Zend_Db_Profiler</classname>. Les profileurs
-        spécialisés traitent les informations de profilage de manière spécifique.</para>
+        <para>
+            Un profileur spécialisé est un objet qui hérite de
+            <classname>Zend_Db_Profiler</classname>. Les profileurs spécialisés traitent les
+            informations de profilage de manière spécifique.
+        </para>
 
         <xi:include href="Zend_Db_Profiler-Firebug.xml" />
     </sect2>

File diff suppressed because it is too large
+ 473 - 268
documentation/manual/fr/module_specs/Zend_Db_Select.xml


+ 164 - 88
documentation/manual/fr/module_specs/Zend_Db_Statement.xml

@@ -1,26 +1,33 @@
-<?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 13846 -->
+<?xml version="1.0" encoding="UTF-8"?>
+<!-- EN-Revision: 15346 -->
 <!-- Reviewed: no -->
 <sect1 id="zend.db.statement">
     <title>Zend_Db_Statement</title>
 
-    <para>En plus des méthodes telles que <code>fetchAll()</code> et <code>insert()</code> documentée dans <xref
-    linkend="zend.db.adapter" />, vous pouvez utiliser un objet statement pour l'analyser de manière plus complète et
-    récupérer vos résultats. Cette section décrit la marche à suivre pour obtenir un statement et utiliser ses méthodes
-    propres.</para>
+    <para>
+        En plus des méthodes telles que <code>fetchAll()</code> et <code>insert()</code>
+        documentée dans <xref linkend="zend.db.adapter" />, vous pouvez utiliser un objet statement
+        pour l'analyser de manière plus complète et récupérer vos résultats. Cette section décrit la
+        marche à suivre pour obtenir un statement et utiliser ses méthodes propres.
+    </para>
 
-    <para>Zend_Db_Statement est basé sur l'objet PDOStatement dans l'extension PHP <ulink
-    url="http://www.php.net/pdo">PHP Data Objects (PDO)</ulink>.</para>
+    <para>
+        Zend_Db_Statement est basé sur l'objet PDOStatement dans l'extension PHP <ulink
+        url="http://www.php.net/pdo">PHP Data Objects (PDO)</ulink>.
+    </para>
 
     <sect2 id="zend.db.statement.creating">
         <title>Créer un statement</title>
 
-        <para>Cet objet est typiquement retourné par la méthode <code>query()</code> de votre objet adaptateur de base
-        de données. Cette méthode prépare un statement SQL : le premier argument est une chaîne représentant la requête
-        préparée, le second, un tableau de paramètres liés.</para>
+        <para>
+            Cet objet est typiquement retourné par la méthode <code>query()</code> de votre
+            objet adaptateur de base de données. Cette méthode prépare un statement SQL : le premier
+            argument est une chaîne représentant la requête préparée, le second, un tableau de
+            paramètres liés.
+        </para>
 
         <example id="zend.db.statement.creating.example1">
-            <title>Création d'un objet statement avec <code>query()</code></title>
+            <title>Création d'un objet statement avec query()</title>
 
             <programlisting role="php"><![CDATA[
 $sql = 'SELECT * FROM bugs WHERE reported_by = ? AND bug_status = ?';
@@ -28,13 +35,18 @@ $stmt = $db->query($sql, array('goofy', 'FIXED'));
 ]]></programlisting>
         </example>
 
-        <para>L'objet statement représente un statement SQL qui a été préparé, et exécuté une fois avec les paramètres
-        de liaison ("bind") spécifiés. S'il s'agissait d'une requête SELECT par exemple, alors les résultats sont prêts
-        à être récupérés.</para>
+        <para>
+            L'objet statement représente un statement SQL qui a été préparé, et exécuté une
+            fois avec les paramètres de liaison ("bind") spécifiés. S'il s'agissait d'une requête
+            SELECT par exemple, alors les résultats sont prêts à être récupérés.
+        </para>
 
-        <para>Vous pouvez créer un statement avec son constructeur, mais c'est assez peu usuel. Passez alors l'objet
-        adaptateur en premier argument, et la chaîne représentant la requête en second. Un fois construit, le statement
-        est préparé automatiquement, mais pas exécuté.</para>
+        <para>
+            Vous pouvez créer un statement avec son constructeur, mais c'est assez peu usuel.
+            Passez alors l'objet adaptateur en premier argument, et la chaîne représentant la
+            requête en second. Un fois construit, le statement est préparé automatiquement, mais pas
+            exécuté.
+        </para>
 
         <example id="zend.db.statement.creating.example2">
             <title>Utilisation du constructeur de statement</title>
@@ -50,12 +62,17 @@ $stmt = new Zend_Db_Statement_Mysqli($db, $sql);
     <sect2 id="zend.db.statement.executing">
         <title>Exécuter un statement</title>
 
-        <para>Vous aurez besoin d'exécuter un statement si vous l'avez crée explicitement avec son constructeur.
-        Utilisez sa méthode <code>execute()</code> pour ceci. Le seul argument que cette méthode accepte est le tableau
-        de "binds" (paramètres préparés).</para>
+        <para>
+            Vous aurez besoin d'exécuter un statement si vous l'avez crée explicitement avec
+            son constructeur. Utilisez sa méthode <code>execute()</code> pour ceci. Le seul argument
+            que cette méthode accepte est le tableau de "binds" (paramètres préparés).
+        </para>
 
-        <para>Si vous utilisez les <emphasis>paramètres positionnés</emphasis>, ceux utilisés avec le point
-        d'interrogation (<code>?</code>), passez simplement les valeurs dans le tableau.</para>
+        <para>
+            Si vous utilisez les <emphasis>paramètres positionnés</emphasis>, ceux utilisés
+            avec le point d'interrogation (<code>?</code>), passez simplement les valeurs dans le
+            tableau.
+        </para>
 
         <example id="zend.db.statement.executing.example1">
             <title>Exécuter un statement avec des paramètres positionnés</title>
@@ -69,8 +86,11 @@ $stmt->execute(array('goofy', 'FIXED'));
 ]]></programlisting>
         </example>
 
-        <para>Si vous utilisez les <emphasis>paramètres nommés</emphasis>, ceux définis avec un identifiant chaîne de
-        caractère précédée d'un (<code>:</code>), passez les valeurs liées sous forme de tableau associatif.</para>
+        <para>
+            Si vous utilisez les <emphasis>paramètres nommés</emphasis>, ceux définis avec un
+            identifiant chaîne de caractère précédée d'un (<code>:</code>), passez les valeurs liées
+            sous forme de tableau associatif.
+        </para>
 
         <example id="zend.db.statement.executing.example2">
             <title>Exécution d'un statement avec paramètres nommés</title>
@@ -86,52 +106,73 @@ $stmt->execute(array(':reporter' => 'goofy', ':status' => 'FIXED'));
 ]]></programlisting>
         </example>
 
-        <para>Les statements PDO acceptent les paramètres positionnés, ou nommés, mais pas les deux types en même temps.
-        Certaines classes Zend_Db_Statement pour les extensions non PDO peuvent ne supporter qu'un seul de ces
-        types.</para>
+        <para>
+            Les statements PDO acceptent les paramètres positionnés, ou nommés, mais pas les
+            deux types en même temps. Certaines classes Zend_Db_Statement pour les extensions non
+            PDO peuvent ne supporter qu'un seul de ces types.
+        </para>
     </sect2>
 
     <sect2 id="zend.db.statement.fetching">
-        <title>Récupérer des résultats depuis un statement <code>SELECT</code></title>
+        <title>Récupérer des résultats depuis un statement SELECT</title>
 
-        <para>Vous disposez de méthodes sur l'objet statement lorsque celui-ci a été exécuté sur une requête SQL de type
-        SELECT, SHOW, DESCRIBE ou EXPLAIN (qui produisent des résultats). Aussi, INSERT, UPDATE et DELETE sont des
-        exemples de requêtes ne produisant pas de résultats. Vous pouvez donc les exécuter avec Zend_Db_Statement, mais
-        vous ne pourrez pas appeler les méthodes de récupération de résultats.</para>
+        <para>
+            Vous disposez de méthodes sur l'objet statement lorsque celui-ci a été exécuté sur
+            une requête SQL de type SELECT, SHOW, DESCRIBE ou EXPLAIN (qui produisent des
+            résultats). Aussi, INSERT, UPDATE et DELETE sont des exemples de requêtes ne produisant
+            pas de résultats. Vous pouvez donc les exécuter avec Zend_Db_Statement, mais vous ne
+            pourrez pas appeler les méthodes de récupération de résultats.
+        </para>
 
         <sect3 id="zend.db.statement.fetching.fetch">
             <title>Récupérer un enregistrement unique depuis un statement</title>
 
-            <para>La méthode <code>fetch()</code> permet de ne récupérer qu'un seul résultat dans le statement
-            précédemment exécuté. Trois paramètres sont disponibles pour cette méthode, tous optionnels :</para>
+            <para>
+                La méthode <code>fetch()</code> permet de ne récupérer qu'un seul résultat
+                dans le statement précédemment exécuté. Trois paramètres sont disponibles pour cette
+                méthode, tous optionnels&#160;:
+            </para>
 
             <itemizedlist>
                 <listitem>
-                    <para><emphasis>Fetch style</emphasis> en premier, permet de spécifier le mode de
-                    capture du résultat. C'est la structure dans laquelle celui-ci vous sera retourné. Voyez <xref
-                    linkend="zend.db.adapter.select.fetch-mode" /> pour une description des valeurs valides et de la
-                    forme des résultats alors renvoyés.</para>
+                    <para>
+                        <emphasis>Fetch style</emphasis> en premier, permet de spécifier le
+                        mode de capture du résultat. C'est la structure dans laquelle celui-ci vous
+                        sera retourné. Voyez <xref linkend="zend.db.adapter.select.fetch-mode" />
+                        pour une description des valeurs valides et de la forme des résultats alors
+                        renvoyés.
+                    </para>
                 </listitem>
 
                 <listitem>
-                    <para><emphasis>Cursor orientation</emphasis> est le second paramètre. Par défaut il
-                    vaut <classname>Zend_Db::FETCH_ORI_NEXT</classname>, ce qui signifie que chaque appel futur à
-                    <code>fetch()</code> retourne l'enregistrement suivant.</para>
+                    <para>
+                        <emphasis>Cursor orientation</emphasis> est le second paramètre. Par
+                        défaut il vaut <classname>Zend_Db::FETCH_ORI_NEXT</classname>, ce qui
+                        signifie que chaque appel futur à <code>fetch()</code> retourne
+                        l'enregistrement suivant.
+                    </para>
                 </listitem>
 
                 <listitem>
-                    <para><emphasis>Offset</emphasis>, en troisième paramètre. Si le paramètre "cursor
-                    orientation" est réglé sur <classname>Zend_Db::FETCH_ORI_ABS</classname>, alors le numéro d'offset est le
-                    numéro du résultat à retourner, dans le statement. Si c'est <classname>Zend_Db::FETCH_ORI_REL</classname>, le
-                    numéro d'offset est relatif à la position du curseur avant l'appel à <code>fetch()</code>.</para>
+                    <para>
+                        <emphasis>Offset</emphasis>, en troisième paramètre. Si le paramètre
+                        "cursor orientation" est réglé sur
+                        <classname>Zend_Db::FETCH_ORI_ABS</classname>, alors le numéro d'offset est
+                        le numéro du résultat à retourner, dans le statement. Si c'est
+                        <classname>Zend_Db::FETCH_ORI_REL</classname>, le numéro d'offset est
+                        relatif à la position du curseur avant l'appel à
+                        <code>fetch()</code>.
+                    </para>
                 </listitem>
             </itemizedlist>
 
-            <para><code>fetch()</code> retourne <code>false</code> si il n'y a plus de résultats restants dans le
-            statement.</para>
+            <para>
+                <code>fetch()</code> retourne <code>false</code> si il n'y a plus de résultats
+                restants dans le statement.
+            </para>
 
             <example id="zend.db.statement.fetching.fetch.example">
-                <title>Utiliser <code>fetch()</code> dans une boucle</title>
+                <title>Utiliser fetch() dans une boucle</title>
 
                 <programlisting role="php"><![CDATA[
 $stmt = $db->query('SELECT * FROM bugs');
@@ -142,19 +183,26 @@ while ($row = $stmt->fetch()) {
 ]]></programlisting>
             </example>
 
-            <para>Voyez aussi <ulink url="http://www.php.net/PDOStatement-fetch">PDOStatement::fetch()</ulink>.</para>
+            <para>
+                Voyez aussi <ulink
+                url="http://www.php.net/PDOStatement-fetch">PDOStatement::fetch()</ulink>.
+            </para>
         </sect3>
 
         <sect3 id="zend.db.statement.fetching.fetchall">
             <title>Récupérer un jeu de résultat complet</title>
 
-            <para>Pour récupérer tous les résultats d'un statement, utilisez <code>fetchAll()</code>. Ceci est
-            équivalent à appeler <code>fetch()</code> dans un boucle et retourner tous les résultats dans un tableau. La
-            méthode <code>fetchAll()</code> accepte deux paramètres. Le premier est le mode de capture (fetch style), le
-            deuxième est le numéro de la colonne à retourner, si Zend_Db::FETCH_COLUMN est utilisé.</para>
+            <para>
+                Pour récupérer tous les résultats d'un statement, utilisez
+                <code>fetchAll()</code>. Ceci est équivalent à appeler <code>fetch()</code> dans un
+                boucle et retourner tous les résultats dans un tableau. La méthode
+                <code>fetchAll()</code> accepte deux paramètres. Le premier est le mode de capture
+                (fetch style), le deuxième est le numéro de la colonne à retourner, si
+                Zend_Db::FETCH_COLUMN est utilisé.
+            </para>
 
             <example id="zend.db.statement.fetching.fetchall.example">
-                <title>Utilisation de <code>fetchAll()</code></title>
+                <title>Utilisation de fetchAll()</title>
 
                 <programlisting role="php"><![CDATA[
 $stmt = $db->query('SELECT * FROM bugs');
@@ -165,20 +213,26 @@ echo $rows[0]['bug_description'];
 ]]></programlisting>
             </example>
 
-            <para>Voyez aussi <ulink
-            url="http://www.php.net/PDOStatement-fetchAll">PDOStatement::fetchAll()</ulink>.</para>
+            <para>
+                Voyez aussi <ulink
+                url="http://www.php.net/PDOStatement-fetchAll">PDOStatement::fetchAll()</ulink>.
+            </para>
         </sect3>
 
         <sect3 id="zend.db.statement.fetching.fetch-mode">
             <title>Changer le mode de capture (Fetch Mode)</title>
 
-            <para>Par défaut l'objet statement retourne les colonnes du jeu de résultat en tant que tableau associatif,
-            en faisant correspondre les noms des colonne et leur valeur. Vous pouvez cependant spécifier un format
-            différent, comme il est possible de faire avec la classe de l'adaptateur. La méthode
-            <code>setFetchMode()</code> permet ceci. Indiquez un mode de capture en utilisant les constantes de la
-            classe Zend_Db : FETCH_ASSOC, FETCH_NUM, FETCH_BOTH, FETCH_COLUMN, et FETCH_OBJ. Voyez <xref
-            linkend="zend.db.adapter.select.fetch-mode" /> pour plus d'informations sur ces modes de capture. Les appels
-            suivants à <code>fetch()</code> ou <code>fetchAll()</code> utiliseront le mode spécifié auparavant.</para>
+            <para>
+                Par défaut l'objet statement retourne les colonnes du jeu de résultat en tant
+                que tableau associatif, en faisant correspondre les noms des colonne et leur valeur.
+                Vous pouvez cependant spécifier un format différent, comme il est possible de faire
+                avec la classe de l'adaptateur. La méthode <code>setFetchMode()</code> permet ceci.
+                Indiquez un mode de capture en utilisant les constantes de la classe Zend_Db :
+                FETCH_ASSOC, FETCH_NUM, FETCH_BOTH, FETCH_COLUMN, et FETCH_OBJ. Voyez <xref
+                linkend="zend.db.adapter.select.fetch-mode" /> pour plus d'informations sur ces
+                modes de capture. Les appels suivants à <code>fetch()</code> ou
+                <code>fetchAll()</code> utiliseront le mode spécifié auparavant.
+            </para>
 
             <example id="zend.db.statement.fetching.fetch-mode.example">
                 <title>Paramétrer le mode de capture (fetch mode)</title>
@@ -194,25 +248,32 @@ echo $rows[0][0];
 ]]></programlisting>
             </example>
 
-            <para>Voyez aussi <ulink
-            url="http://www.php.net/PDOStatement-setFetchMode">PDOStatement::setFetchMode()</ulink>.</para>
+            <para>
+                Voyez aussi <ulink
+                url="http://www.php.net/PDOStatement-setFetchMode">PDOStatement::setFetchMode()</ulink>.
+            </para>
         </sect3>
 
         <sect3 id="zend.db.statement.fetching.fetchcolumn">
             <title>Récupérer une colonne simple depuis un statement exécuté</title>
 
-            <para>Pour retourner une colonne de résultat depuis un statement, utilisez la méthode
-            <code>fetchColumn()</code>. Le paramètre optionnel est un entier représentant l'index de la colonne désirée,
-            par défaut zéro. Cette méthode retourne un type scalaire, ou <code>false</code> s'il n'y a plus de résultats
-            dans le statement.</para>
-
-            <para>Notez que cette méthode se comporte différemment de <code>fetchCol()</code> de l'adaptateur. La
-            méthode <code>fetchColumn()</code> du statement retourne une seule valeur d'un seul résultat.
-            <code>fetchCol()</code> de l'adaptateur retourne un tableau de valeurs issues de la première colonne du jeu
-            résultat.</para>
+            <para>
+                Pour retourner une colonne de résultat depuis un statement, utilisez la
+                méthode <code>fetchColumn()</code>. Le paramètre optionnel est un entier
+                représentant l'index de la colonne désirée, par défaut zéro. Cette méthode retourne
+                un type scalaire, ou <code>false</code> s'il n'y a plus de résultats dans le
+                statement.
+            </para>
+
+            <para>
+                Notez que cette méthode se comporte différemment de <code>fetchCol()</code> de
+                l'adaptateur. La méthode <code>fetchColumn()</code> du statement retourne une seule
+                valeur d'un seul résultat. <code>fetchCol()</code> de l'adaptateur retourne un
+                tableau de valeurs issues de la première colonne du jeu résultat.
+            </para>
 
             <example id="zend.db.statement.fetching.fetchcolumn.example">
-                <title>Utiliser <code>fetchColumn()</code></title>
+                <title>Utiliser fetchColumn()</title>
 
                 <programlisting role="php"><![CDATA[
 $sql = 'SELECT bug_id, bug_description, bug_status FROM bugs';
@@ -223,21 +284,26 @@ $bug_status = $stmt->fetchColumn(2);
 ]]></programlisting>
             </example>
 
-            <para>Voyez aussi <ulink
-            url="http://www.php.net/PDOStatement-fetchColumn">PDOStatement::fetchColumn()</ulink>.</para>
+            <para>
+                Voyez aussi <ulink
+                url="http://www.php.net/PDOStatement-fetchColumn">PDOStatement::fetchColumn()</ulink>.
+            </para>
         </sect3>
 
         <sect3 id="zend.db.statement.fetching.fetchobject">
             <title>Récupérer un résultat (Row) sous forme d'objet</title>
 
-            <para>Pour récupérer une colonne de résultat en tant qu'objet, depuis un statement exécuté, utilisez la
-            méthode <code>fetchObject()</code>. Celle-ci prend deux paramètres optionnels. Le premier est une chaîne
-            indiquant le nom de la classe que l'on souhaite se voir retourner, par défaut il s'agit de
-            "<code>stdClass</code>". Le deuxième paramètre est un tableau de paramètres qui sera passé au constructeur
-            de cette classe.</para>
+            <para>
+                Pour récupérer une colonne de résultat en tant qu'objet, depuis un statement
+                exécuté, utilisez la méthode <code>fetchObject()</code>. Celle-ci prend deux
+                paramètres optionnels. Le premier est une chaîne indiquant le nom de la classe que
+                l'on souhaite se voir retourner, par défaut il s'agit de "<code>stdClass</code>". Le
+                deuxième paramètre est un tableau de paramètres qui sera passé au constructeur de
+                cette classe.
+            </para>
 
             <example id="zend.db.statement.fetching.fetchobject.example">
-                <title>Utiliser <code>fetchObject()</code></title>
+                <title>Utiliser fetchObject()</title>
 
                 <programlisting role="php"><![CDATA[
 $sql = 'SELECT bug_id, bug_description, bug_status FROM bugs';
@@ -250,8 +316,10 @@ echo $obj->bug_description;
 ]]></programlisting>
             </example>
 
-            <para>Voyez aussi <ulink
-            url="http://www.php.net/PDOStatement-fetchObject">PDOStatement::fetchObject()</ulink>.</para>
+            <para>
+                Voyez aussi <ulink
+                url="http://www.php.net/PDOStatement-fetchObject">PDOStatement::fetchObject()</ulink>.
+            </para>
         </sect3>
     </sect2>
 
@@ -263,6 +331,8 @@ echo $obj->bug_description;
         <title>Binding PHP Variables to Parameters</title>
 
         <para>
+
+
         </para>
 
         <example id="zend.db.statement.binding-param.example">
@@ -272,7 +342,9 @@ echo $obj->bug_description;
         </example>
 
         <para>
-            See also <ulink url="http://www.php.net/PDOStatement-bindParam">PDOStatement::bindParam()</ulink>.
+
+                See also <ulink url="http://www.php.net/PDOStatement-bindParam">PDOStatement::bindParam()</ulink>.
+
         </para>
 
     </sect2>
@@ -285,6 +357,8 @@ echo $obj->bug_description;
         <title>Binding PHP Variables to Query Results</title>
 
         <para>
+
+
         </para>
 
         <example id="zend.db.statement.binding-column.example">
@@ -294,7 +368,9 @@ echo $obj->bug_description;
         </example>
 
         <para>
-            See also <ulink url="http://www.php.net/PDOStatement-bindColumn">PDOStatement::bindColumn()</ulink>.
+
+                See also <ulink url="http://www.php.net/PDOStatement-bindColumn">PDOStatement::bindColumn()</ulink>.
+
         </para>
 
     </sect2>

Some files were not shown because too many files changed in this diff