[DOCUMENTATION] French: sync manual

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

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

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: 17232 -->
+<!-- EN-Revision: 19452 -->
 <!-- Reviewed: no -->
 <sect1 id="zend.http.client.advanced">
     <title>Zend_Http_Client - Utilisation avancée</title>
@@ -255,7 +255,9 @@ $client->setRawData($xml)->setEncType('text/xml')->request('POST');
         <para>
             Actuellement, <classname>Zend_Http_Client</classname> propose uniquement
             l'authentification HTTP "basic". Cette fonctionnalité est utilisée via la méthode
-            <methodname>setAuth()</methodname>. Celle-ci accepte trois paramètres : le nom d'utilisateur, le mot
+            <methodname>setAuth()</methodname>, ou en spécifiant le nom d'utilisateur et le mot
+            de passe dans l'URI. La méthode <methodname>setAuth()</methodname> accepte trois
+            paramètres : le nom d'utilisateur, le mot
             de passe et un type d'authentification optionnel. Comme mentionné, seule
             l'authentification "basic" est actuellement implémentée (l'ajout de l'authentification
             "digest" est planifié). <example id="zend.http.client.http_authentication.example-1">
@@ -271,6 +273,10 @@ $client->setAuth('shahar',
 // L'authentification 'basic' étant le comportement par défaut,
 // on peut aussi écrire ceci :
 $client->setAuth('shahar', 'monMotdePasse!');
+
+// Vous pouvez aussi spécifier le nom d'utilisateur
+// et le mot de passe dans l'URI
+$client->setUri('http://christer:secret@example.com');
 ]]></programlisting>
                 </example>
             </para>
@@ -307,12 +313,17 @@ $client->setAuth('shahar', 'monMotdePasse!');
             <title>Réinitialiser les paramètres</title>
 
             <para>
-                Notez que les en-têtes spécifiques non liés à la requête ne sont pas
-                réinitialisés quand la méthode <code>resetParameters</code> est invoquée. En fait,
-                seuls les en-têtes "Content-length" et "Content-type" sont supprimés. Ceci permet de
-                définir une seule fois les en-têtes comme "Accept-language" ou
+                Notez que les en-têtes spécifiques non liés à la requête ne sont pas réinitialisés
+                par défaut quand la méthode <methodname>resetParameters</methodname> est invoquée.
+                En fait, seuls les en-têtes "Content-length" et "Content-type" sont supprimés.
+                Ceci permet de définir une seule fois les en-têtes comme "Accept-language" ou
                 "Accept-encoding".
             </para>
+
+            <para>
+                Pour effacer tous les entêtes et toutes les données excepté l'URI et la méthode,
+                utilisez <methodname>resetParameters(true)</methodname>.
+            </para>
         </note>
 
         <para>
@@ -368,4 +379,65 @@ $_SESSION['cookiejar'] = $client->getCookieJar();
 ]]></programlisting>
         </example>
     </sect2>
-</sect1>
+
+    <sect2 id="zend.http.client.streaming">
+        <title>Data Streaming</title>
+        <para>
+            By default, <classname>Zend_Http_Client</classname> accepts and returns data as PHP strings.
+            However, in many cases there are big files to be sent or received, thus keeping them
+            in memory might be unnecessary or too expensive. For these cases, <classname>Zend_Http_Client</classname>
+            supports reading data from files (and in general, PHP streams) and writing data to files (streams).
+        </para>
+        <para>
+            In order to use stream to pass data to <classname>Zend_Http_Client</classname>,
+            use <methodname>setRawData()</methodname> method with data argument being stream resource
+            (e.g., result of <methodname>fopen()</methodname>).
+            <example id="zend.http.client.streaming.example-1">
+                <title>Sending file to HTTP server with streaming</title>
+
+                <programlisting language="php"><![CDATA[
+$fp = fopen("mybigfile.zip", "r");
+$client->setRawData($fp, 'application/zip')->request('PUT');
+]]></programlisting>
+            </example>
+        </para>
+
+        <para>
+            Only PUT requests currently support sending streams to HTTP server.
+        </para>
+
+        <para>
+            In order to receive data from the server as stream, use <methodname>setStream()</methodname>.
+            Optional argument specifies the filename where the data will be stored. If the argument is just
+            TRUE (default), temporary file will be used and will be deleted once response object is destroyed.
+            Setting argument to FALSE disables the streaming functionality.
+        </para>
+
+        <para>
+            When using streaming, <methodname>request()</methodname> method will return object of class
+            <classname>Zend_Http_Client_Response_Stream</classname>, which has two useful methods:
+            <methodname>getStreamName()</methodname> will return the name of the file where the response is stored,
+            and <methodname>getStream()</methodname> will return stream from which the response could be read.
+        </para>
+
+        <para>
+            You can either write the response to pre-defined file, or use temporary file for storing it and
+            send it out or write it to another file using regular stream functions.
+            <example id="zend.http.client.streaming.example-2">
+                <title>Receiving file from HTTP server with streaming</title>
+
+                <programlisting language="php"><![CDATA[
+$client->setStreaming(); // will use temp file
+$response = $client->request('GET');
+// copy file
+copy($response->getStreamName(), "my/downloads/file");
+// use stream
+$fp = fopen("my/downloads/file2", "w");
+stream_copy_to_stream($response->getStream(), $fp);
+// Also can write to known file
+$client->setStreaming("my/downloads/myfile)->request('GET');
+]]></programlisting>
+            </example>
+        </para>
+    </sect2>
+</sect1>

documentation/manual/fr/ref/language-snippets.xml

@@ -1,4 +1,4 @@
-<?xml version="1.0" encoding="utf-8"?>
+<?xml version="1.0" encoding="utf-8"?>
 <!-- EN-Revision: 19887 -->
 <!-- Reviewed: no -->
 
@@ -7,13 +7,13 @@
 <!ENTITY zf.manual.link                         'http://framework.zend.com/manual/fr/'>
 <!ENTITY php.manual.link                        'http://www.php.net/manual/fr/'>
 
-<!-- manual.xml.in -->
-<!ENTITY book.title                             'Guide de référence du programmeur'>
+<!-- manual.xml.in -->
+<!ENTITY book.title                             'Guide de référence du programmeur'>
 <!ENTITY book.pdf1.title                        'Guide de référence du programmeur : Volume 1'>
 <!ENTITY book.pdf2.title                        'Guide de référence du programmeur : Volume 2'>
-<!ENTITY book.subtitle                          'Zend Framework'>
-<!ENTITY book.edition                           'Guide de référence de Zend Framework destiné au programmeur'>
-
+<!ENTITY book.subtitle                          'Zend Framework'>
+<!ENTITY book.edition                           'Guide de référence de Zend Framework destiné au programmeur'>
+
 <!ENTITY chapter.introduction.title             'Introduction au Zend Framework'>
 
 <!ENTITY part.learning.title                    'Apprendre Zend Framework'>