[DOCUMENTATION] French:

 - sync manual

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

documentation/manual/fr/module_specs/Zend_Application-AvailableResources-Db.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: 16650 -->
+<!-- EN-Revision: 16845 -->
 <!-- Reviewed: no -->
 <sect2 id="zend.application.available-resources.db">
     <title>Zend_Application_Resource_Db</title>
@@ -17,18 +17,19 @@
 
     <itemizedlist>
         <listitem><para>
-            <property>adapter</property>&#160;: le type de l'adaptateur
+            <emphasis><property>adapter</property></emphasis>&#160;: le type de l'adaptateur
             <classname>Zend_Db</classname>.
         </para></listitem>
 
         <listitem><para>
-            <property>params</property>&#160;: un tableau associatif des paramètres de configuration
-            à utiliser pour la récupération de l'instance de l'adaptateur.
+            <emphasis><property>params</property></emphasis>&#160;: un tableau associatif des
+            paramètres de configuration à utiliser pour la récupération de l'instance de
+            l'adaptateur.
         </para></listitem>
 
         <listitem><para>
-            <property>isDefaultTableAdapter</property>&#160;: spécifie si l'adaptateur est celui par
-            défaut des tables.
+            <emphasis><property>isDefaultTableAdapter</property></emphasis>&#160;: spécifie
+            si l'adaptateur est celui par défaut des tables.
         </para></listitem>
     </itemizedlist>
 

documentation/manual/fr/module_specs/Zend_Application-AvailableResources-Frontcontroller.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: 16650 -->
+<!-- EN-Revision: 16847 -->
 <!-- Reviewed: no -->
 <sect2 id="zend.application.available-resources.frontcontroller">
     <title>Zend_Application_Resource_Frontcontroller</title>
@@ -24,50 +24,51 @@
 
     <itemizedlist>
         <listitem><para>
-            <property>controllerDirectory</property>&#160;: une chaîne de caractères spécifiant un
-            seul dossier de contrôleurs, ou un tableau associant un nom de module et un dossier de
-            contrôleurs.
+            <emphasis><property>controllerDirectory</property></emphasis>&#160;: une chaîne de
+            caractères spécifiant un seul dossier de contrôleurs, ou un tableau associant un
+            nom de module et un dossier de contrôleurs.
         </para></listitem>
 
         <listitem><para>
-            <property>moduleControllerDirectoryName</property>&#160;: une chaîne de caractères
-            indiquant un sous-dossier dans ce module qui contient les contrôleurs.
+            <emphasis><property>moduleControllerDirectoryName</property></emphasis>&#160;: une
+            chaîne de caractères indiquant un sous-dossier dans ce module qui contient les
+            contrôleurs.
         </para></listitem>
 
         <listitem><para>
-            <property>moduleDirectory</property>&#160;: un dossier dans lequel tous les modules
-            peuvent être trouvés.
+            <emphasis><property>moduleDirectory</property></emphasis>&#160;: un dossier dans
+            lequel tous les modules peuvent être trouvés.
         </para></listitem>
 
         <listitem><para>
-            <property>defaultControllerName</property>&#160;: nom du contrôleur par défaut
-            (normalement "index").
+            <emphasis><property>defaultControllerName</property></emphasis>&#160;: nom du
+            contrôleur par défaut (normalement "index").
         </para></listitem>
 
         <listitem><para>
-            <property>defaultAction</property>&#160;: nom de l'action par défaut (normalement
-            "index").
+            <emphasis><property>defaultAction</property></emphasis>&#160;: nom de l'action par
+            défaut (normalement "index").
         </para></listitem>
 
         <listitem><para>
-            <property>defaultModule</property>&#160;: nom du module par défaut (normalement
-            "default").
+            <emphasis><property>defaultModule</property></emphasis>&#160;: nom du module par
+            défaut (normalement "default").
         </para></listitem>
 
         <listitem><para>
-            <property>baseUrl</property>&#160;: <acronym>URL</acronym> de base explicite vers
-            l'application (normalement auto-détecté).
+            <emphasis><property>baseUrl</property></emphasis>&#160;: <acronym>URL</acronym>
+            de base explicite vers l'application (normalement auto-détecté).
         </para></listitem>
 
         <listitem><para>
-            <property>plugins</property>&#160;: tableau de nom de classe de plugins de contrôleurs.
-            La ressource instanciera chaque classe (sans arguments de contructeur) et les
-            enregistrera dans le contrôleur frontal.
+            <emphasis><property>plugins</property></emphasis>&#160;: tableau de nom de classe
+            de plugins de contrôleurs. La ressource instanciera chaque classe (sans arguments
+            de contructeur) et les enregistrera dans le contrôleur frontal.
         </para></listitem>
 
         <listitem><para>
-            <property>params</property>&#160;: tableau de paires clés / valeurs à enregistrer dans
-            le contrôleur frontal.
+            <emphasis><property>params</property></emphasis>&#160;: tableau de paires
+            clés&#160;/&#160;valeurs à enregistrer dans le contrôleur frontal.
         </para></listitem>
     </itemizedlist>
 

documentation/manual/fr/module_specs/Zend_Auth_Adapter_DbTable.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 16652 -->
+<!-- EN-Revision: 16855 -->
 <!-- Reviewed: no -->
 <sect1 id="zend.auth.adapter.dbtable">
     <title>Authentification avec une table de base de données</title>
@@ -24,35 +24,36 @@
         <itemizedlist>
             <listitem>
                 <para>
-                    <property>tableName</property>&#160;: il s'agit du nom de la table dans la
-                    base de données qui contient les crédits d'authentification, et envers laquelle la
-                    requête d'authentification sera réalisée.
+                    <emphasis><property>tableName</property></emphasis>&#160;: il s'agit du nom de
+                    la table dans la base de données qui contient les crédits d'authentification,
+                    et envers laquelle la requête d'authentification sera réalisée.
                 </para>
             </listitem>
             <listitem>
                 <para>
-                    <property>identityColumn</property>&#160;: il s'agit du nom de la colonne dans
-                    la table utilisée pour représenter l'identité. La colonne d'identité doit
-                    contenir une valeur unique, comme un "username" ou une adresse
-                    émail.
+                    <emphasis><property>identityColumn</property></emphasis>&#160;: il s'agit du
+                    nom de la colonne dans la table utilisée pour représenter l'identité. La
+                    colonne d'identité doit contenir une valeur unique, comme un "username" ou
+                    une adresse émail.
                 </para>
             </listitem>
             <listitem>
                 <para>
-                    <property>credentialColumn</property>&#160;: il s'agit du nom de la colonne
-                    dans la table utilisée pour représenter le crédit. Dans le cas d'une simple
-                    authentification par identité / mot de passe, la valeur de crédit
-                    correspond au mot de passe. Voir aussi l'option
+                    <emphasis><property>credentialColumn</property></emphasis>&#160;: il s'agit
+                    du nom de la colonne dans la table utilisée pour représenter le crédit. Dans
+                    le cas d'une simple authentification par identité / mot de passe, la valeur
+                    de crédit correspond au mot de passe. Voir aussi l'option
                     <property>credentialTreatment</property>.
                 </para>
             </listitem>
             <listitem>
                 <para>
-                    <property>credentialTreatment</property>&#160;: dans la plupart des cas, les
-                    mots de passe et autres données sensibles sont cryptés, hachés, encodés,
-                    masqués, ou sinon traités à travers une fonction ou un algorithme. En
-                    spécifiant un traitement paramétrable de chaîne avec cette méthode, comme
-                    <methodname>MD5(?)</methodname> ou <methodname>PASSWORD(?)</methodname>, un
+                    <emphasis><property>credentialTreatment</property></emphasis>&#160;: dans la
+                    plupart des cas, les mots de passe et autres données sensibles sont cryptés,
+                    hachés, encodés, masqués, ou sinon traités à travers une fonction ou un
+                    algorithme. En spécifiant un traitement paramétrable de chaîne avec cette
+                    méthode, comme <methodname>MD5(?)</methodname> ou
+                    <methodname>PASSWORD(?)</methodname>, un
                     développeur peut appliquer un code <acronym>SQL</acronym> arbitraire sur les
                     données de crédit fournies. Comme ces fonctions sont spécifiques à chaque
                     gestionnaire de base de données (<acronym>SGBD</acronym>), vérifiez le manuel

documentation/manual/fr/module_specs/Zend_Auth_Adapter_Http.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 16652 -->
+<!-- EN-Revision: 16855 -->
 <!-- Reviewed: no -->
 <sect1 id="zend.auth.adapter.http">
     <title>Adaptateur d'authentification HTTP</title>
@@ -101,7 +101,7 @@
                 </thead>
                 <tbody>
                     <row>
-                        <entry><property>accept_schemes</property></entry>
+                        <entry><emphasis><property>accept_schemes</property></emphasis></entry>
                         <entry>Oui</entry>
                         <entry>
                             Détermine les schémas d'authentification que l'adaptateur va
@@ -111,7 +111,7 @@
                         </entry>
                     </row>
                     <row>
-                        <entry><property>realm</property></entry>
+                        <entry><emphasis><property>realm</property></emphasis></entry>
                         <entry>Oui</entry>
                         <entry>
                             Fournit le nom de l'authentification ("realm")&#160;;
@@ -120,7 +120,7 @@
                         </entry>
                     </row>
                     <row>
-                        <entry><property>digest_domains</property></entry>
+                        <entry><emphasis><property>digest_domains</property></emphasis></entry>
                         <entry>
                             Oui lorsque <property>accept_schemes</property> contient
                             <emphasis>"digest"</emphasis>
@@ -132,7 +132,7 @@
                         </entry>
                     </row>
                     <row>
-                        <entry><property>nonce_timeout</property></entry>
+                        <entry><emphasis><property>nonce_timeout</property></emphasis></entry>
                         <entry>
                             Oui lorsque <property>accept_schemes</property> contient
                             <emphasis>"digest"</emphasis>
@@ -143,7 +143,7 @@
                         </entry>
                     </row>
                     <row>
-                        <entry><property>proxy_auth</property></entry>
+                        <entry><emphasis><property>proxy_auth</property></emphasis></entry>
                         <entry>Non</entry>
                         <entry>
                             Désactivé par défaut. Activez le pour effectuer une

documentation/manual/fr/module_specs/Zend_Captcha-Adapters.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 16465 -->
+<!-- EN-Revision: 16674 -->
 <!-- Reviewed: no -->
 <sect1 id="zend.captcha.adapters">
     <title>Adaptateurs CAPTCHA</title>
@@ -159,7 +159,7 @@
                     <methodname>setGcFreq($gcFreq)</methodname> et
                     <methodname>getGcFreg()</methodname> vous
                     permettent de manipuler la fréquence de collecte du ramasse-miettes des images.
-                    Le ramasse-miettes passera à une fréquence de <emphasis>1/$gcFreq</emphasis>.
+                    Le ramasse-miettes passera à une fréquence de <command>1/$gcFreq</command>.
                     Par défaut 1&#160;/&#160;100, soit toutes les 100 requêtes.
                 </para>
             </listitem>

documentation/manual/fr/module_specs/Zend_Config-TheoryOfOperation.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 16393 -->
+<!-- EN-Revision: 16674 -->
 <!-- Reviewed: no -->
 <sect1 id="zend.config.theory_of_operation">
     <title>Aspect théorique</title>
@@ -38,7 +38,7 @@
     <para>
         Par défaut, les données de configuration fournies par <classname>Zend_Config</classname> ne
         sont pas modifiables (lecture seule), et une affectation (par exemple,
-        <command>$config-&gt;database-&gt;host = 'example.com'</command>) lèvera une exception. Ce
+        <command>$config->database->host = 'example.com';</command>) lèvera une exception. Ce
         comportement par défaut peut cependant être surchargé par le constructeur pour permettre la
         modification des valeurs de données. De plus, quand les modifications sont autorisées,
         <classname>Zend_Config</classname> supporte l'effacement de valeurs (c'est-à-dire
@@ -90,7 +90,7 @@
         un objet unique en utilisant la fonction <methodname>merge()</methodname>. Par exemple,
         prenons <varname>$config</varname> et <varname>$localConfig</varname>, vous pouvez fusionner
         <varname>$localConfig</varname> dans <varname>$config</varname> en utilisant
-        <methodname>$config->merge($localConfig)</methodname>. Les éléments de
+        <command>$config->merge($localConfig);</command>. Les éléments de
         <varname>$localConfig</varname> surchargeront les éléments nommés de la même manière dans
         <varname>$config</varname>.
     </para>

documentation/manual/fr/module_specs/Zend_Http_Client-Adapters.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: 16603 -->
+<!-- EN-Revision: 17023 -->
 <!-- Reviewed: no -->
 <sect1 id="zend.http.client.adapters">
     <title>Zend_Http_Client - Adaptateurs de connexion</title>
@@ -28,11 +28,11 @@
                     </listitem>
 
                     <listitem>
-                        <para><classname>Zend_Http_Client_Adapter_Test</classname></para>
+                        <para><classname>Zend_Http_Client_Adapter_Curl</classname></para>
                     </listitem>
 
                     <listitem>
-                        <para><classname>Zend_Http_Client_Adapter_Curl</classname></para>
+                        <para><classname>Zend_Http_Client_Adapter_Test</classname></para>
                     </listitem>
                 </itemizedlist>
             </para>
@@ -169,6 +169,96 @@ $response = $client->request();
         </para>
 
         <para><code>fsockopen('tls://www.example.com', 443)</code></para>
+        
+        <sect3 id="zend.http.client.adapters.socket.streamcontext">
+            <title>Customizing and accessing the Socket adapter stream context</title>
+            <para>
+                Starting from Zend Framework 1.9, <classname>Zend_Http_Client_Adapter_Socket</classname> 
+                provides direct access to the underlying <ulink url="http://php.net/manual/en/stream.contexts.php">stream context</ulink>
+                used to connect to the remote server. This allows the user to pass 
+                specific options and parameters to the TCP stream, and to the SSL wrapper in
+                case of HTTPS connections.
+            </para>
+                        
+            <para>
+                You can access the stream context using the following methods of <classname>Zend_Http_Client_Adapter_Socket</classname>:
+                <itemizedlist>
+                    <listitem>
+                        <para>
+                            <firstterm><classname>setStreamContext($context)</classname></firstterm>
+	                        Sets the stream context to be used by the adapter. Can accept either
+	                        a stream context resource created using the 
+	                        <ulink url="http://php.net/manual/en/function.stream-context-create.php"><classname>stream_context_create()</classname></ulink>
+	                        PHP function, or an array of stream context options, in the same format provided to this function. 
+	                        Providing an array will create a new stream context using these options, and set it.
+	                    </para>
+	                </listitem>
+	                <listitem>
+	                    <para>
+	                        <firstterm><classname>getStreamContext()</classname></firstterm>
+	                        Get the stream context of the adapter. If no stream context was set, 
+	                        will create a default stream context and return it. You can then set
+	                        or get the value of different context options using regular PHP stream
+	                        context functions.
+	                    </para>
+	                </listitem>
+	            </itemizedlist>    
+            </para>
+            <example id="zend.http.client.adapters.socket.streamcontext.example-1">
+            <title>Setting stream context options for the Socket adapter</title>
+            <programlisting language="php"><![CDATA[
+// Array of options
+$options = array(
+    'socket' => array(  
+        // Bind local socket side to a specific interface
+        'bindto' => '10.1.2.3:50505'
+    ),
+    'ssl' => array(
+        // Verify server side certificate, 
+        // do not accept invalid or self-signed SSL certificates
+        'verify_peer' => true,
+        'allow_self_signed' => false,
+        
+        // Capture the peer's certificate
+        'capture_peer_cert' => true
+    )
+);
+
+// Create an adapter object and attach it to the HTTP client
+$adapter = new Zend_Http_Client_Adapter_Socket();
+$client = new Zend_Http_Client();
+$client->setAdapter($adapter);
+
+// Method 1: pass the options array to setStreamContext()
+$adapter->setStreamContext($options);
+
+// Method 2: create a stream context and pass it to setStreamContext()
+$context = stream_context_create($options);
+$adapter->setStreamContext($context);
+
+// Method 3: get the default stream context and set the options on it
+$context = $adapter->getStreamContext();
+stream_context_set_option($context, $options);
+
+// Now, preform the request
+$response = $client->request();
+
+// If everything went well, you can now access the context again 
+$opts = stream_context_get_options($adapter->getStreamContext());
+echo $opts['ssl']['peer_certificate'];
+]]></programlisting>
+        </example>
+
+        <note>
+            <para>
+                Note that you must set any stream context options before using the adapter
+                to preform actual requests. If no context is set before preforming HTTP requests
+                with the Socket adapter, a default stream context will be created. This context
+                resource could be accessed after preforming any requests using the 
+                <classname>getStreamContext()</classname> method.
+            </para>
+        </note>
+        </sect3>
     </sect2>
 
     <sect2 id="zend.http.client.adapters.proxy">
@@ -280,6 +370,72 @@ $client = new Zend_Http_Client('http://www.example.com', $config);
             alors le client utilisera l'adaptateur Socket par défaut. Ceci est utile si le proxy est
             utilisé optionnellement, ou par intermittence.
         </para>
+        
+        <note>
+            <para>
+                Since the proxy adapter inherits from <classname>Zend_Http_Client_Adapter_Socket</classname>,
+                you can use the stream context access method (see <xref linkend="zend.http.client.adapters.socket.streamcontext" />)
+                to set stream context options on Proxy connections as demonstrated above.
+            </para>
+        </note>
+    </sect2>
+
+
+    <sect2 id="zend.http.client.adapters.curl">
+        <title>The cURL Adapter</title>
+        <para>
+            cURL is a standard HTTP client library that is distributed with many
+            operating systems and can be used in PHP via the cURL extension. It
+            offers functionality for many special cases which can occur for a HTTP
+            client and make it a perfect choice for a HTTP adapter. It supports
+            secure connections, proxy, all sorts of authentication mechanisms
+            and shines in applications that move large files around between servers.
+        </para>
+
+        <example id="zend.http.client.adapters.curl.example-1">
+            <title>Setting cURL options</title>
+            <programlisting language="php"><![CDATA[
+$config = array(
+    'adapter'   => 'Zend_Http_Client_Adapter_Curl',
+    'curloptions' => array(CURLOPT_FOLLOWLOCATION => true),
+);
+$client = new Zend_Http_Client($uri, $config);
+]]></programlisting>
+        </example>
+
+        <para>
+            By default the cURL adapter is configured to behave exactly like
+            the Socket Adapter and it also accepts the same configuration parameters
+            as the Socket and Proxy adapters. You can also change the cURL options by either specifying
+            the 'curloptions' key in the constructor of the adapter or by calling
+            <code>setCurlOption($name, $value)</code>. The <code>$name</code> key
+            corresponds to the CURL_* constants of the cURL extension. You can
+            get access to the Curl handle by calling <code>$adapter->getHandle();</code>
+        </para>
+
+        <example id="zend.http.client.adapters.curl.example-2">
+            <title>Transfering Files by Handle</title>
+
+            <para>
+                You can use cURL to transfer very large files over HTTP by filehandle.
+            </para>
+
+            <programlisting language="php"><![CDATA[
+$putFileSize   = filesize("filepath");
+$putFileHandle = fopen("filepath", "r");
+
+$adapter = new Zend_Http_Client_Adapter_Curl();
+$client = new Zend_Http_Client();
+$client->setAdapter($adapter);
+$adapter->setConfig(array(
+    'curloptions' => array(
+        CURLOPT_INFILE => $putFileHandle,
+        CURLOPT_INFILESIZE => $putFileSize
+    )
+));
+$client->request("PUT");
+]]></programlisting>
+        </example>
     </sect2>
 
     <sect2 id="zend.http.client.adapters.test">
@@ -407,63 +563,6 @@ $adapter->addResponse(
         </para>
     </sect2>
 
-    <sect2 id="zend.http.client.adapters.curl">
-        <title>The cURL Adapter</title>
-
-        <para>
-            cURL is a standard HTTP client library that is distributed with many
-            operating systems and can be used in PHP via the cURL extension. It
-            offers functionality for many special cases which can occur for a HTTP
-            client and make it a perfect choice for a HTTP adapter. It supports
-            secure connections, proxy, all sorts of authentication mechanisms
-            and shines in applications that move large files around between servers.
-        </para>
-
-        <example id="zend.http.client.adapters.curl.example-1">
-            <title>Setting cURL options</title>
-
-            <programlisting language="php"><![CDATA[
-$config = array(
-    'adapter'   => 'Zend_Http_Client_Adapter_Curl',
-    'curloptions' => array(CURLOPT_FOLLOWLOCATION => true),
-);
-$client = new Zend_Http_Client($uri, $config);
-]]></programlisting>
-        </example>
-
-        <para>
-            By default the cURL adapter is configured to behave exactly like
-            the Socket Adapter and it also accepts the same configuration parameters
-            as the Socket and Proxy adapters. You can also change the cURL options by either
-            specifying the 'curloptions' key in the constructor of the adapter or by calling
-            <code>setCurlOption($name, $value)</code>. The <code>$name</code> key
-            corresponds to the CURL_* constants of the cURL extension. You can
-            get access to the Curl handle by calling <code>$adapter->getHandle();</code>
-        </para>
-
-        <example id="zend.http.client.adapters.curl.example-2">
-            <title>Transfering Files by Handle</title>
-
-            <para>
-                You can use cURL to transfer very large files over HTTP by filehandle.
-            </para>
-
-            <programlisting language="php"><![CDATA[
-$putFileSize   = filesize("filepath");
-$putFileHandle = fopen("filepath", "r");
-
-$adapter = new Zend_Http_Client_Adapter_Curl();
-$client = new Zend_Http_Client();
-$client->setAdapter($adapter);
-$adapter->setConfig(array(
-    'curloptions' => array(CURLOPT_INFILE => $putFileHandle,
-                           CURLOPT_INFILESIZE => $putFileSize)
-));
-$client->request("PUT");
-]]></programlisting>
-        </example>
-    </sect2>
-
     <sect2 id="zend.http.client.adapters.extending">
         <title>Créer vos propres adaptateurs de connexion</title>