[MANUAL] German:

 - added review

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

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

@@ -1,28 +1,28 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!-- EN-Revision: 22769 -->
-<!-- Reviewed: no -->
+<!-- Reviewed: 22769 -->
 <sect1 id="zend.http.client.advanced">
     <title>Zend_Http_Client - Fortgeschrittende Nutzung</title>
 
     <sect2 id="zend.http.client.redirections">
-        <title>HTTP Umleitungen</title>
+        <title>HTTP-Umleitungen</title>
 
         <para>
             Standardmäßig verarbeitet <classname>Zend_Http_Client</classname>
-            <acronym>HTTP</acronym> Umleitungen automatisch und folgt bis zu 5 Umleitungen. Dies
-            kann durch Setzen des 'maxredirects' Konfigurationsparameters gändert werden.
+            <acronym>HTTP</acronym>-Umleitungen automatisch und folgt bis zu 5 Umleitungen. Dies
+            kann durch Setzen des Konfigurationsparameters 'maxredirects' gändert werden.
         </para>
 
         <para>
             Gemäß dem <acronym>HTTP</acronym>/1.1 RFC sollten <acronym>HTTP</acronym> 301 und 302
-            Antworten vom Client behandelt werden, indem die selbe Anfrage erneut an die angebene
-            Stelle versendet wird - unter Verwendung der selben Anfragemethode. Allerdings haben
+            Antworten vom Client behandelt werden, indem dieselbe Anfrage erneut an die angebene
+            Stelle versendet wird - unter Verwendung derselben Anfragemethode. Allerdings haben
             dies die meisten Clients nicht implementiert und verwenden beim Umleiten eine
-            <constant>GET</constant> Anfrage. Standardmäßig macht
+            <constant>GET</constant>-Anfrage. Standardmäßig macht
             <classname>Zend_Http_Client</classname> genau dasselbe - beim Umleiten einer 301 oder
-            302 Antwort, werden alle <constant>GET</constant> und POST Parameter zurückgesetzt und
-            eine <constant>GET</constant> Anfrage wird an die neue Stelle versandt. Dieses Verhalten
-            kann durch Setzen des 'strictredirects' Konfigurationsparameters auf das boolesche
+            302 Antwort, werden alle <constant>GET</constant>- und POST-Parameter zurückgesetzt und
+            eine <constant>GET</constant>-Anfrage wird an die neue Stelle versandt. Dieses Verhalten
+            kann durch Setzen des Konfigurationsparameters 'strictredirects' auf das boolesche
             <constant>TRUE</constant> geändert werden.
 
             <example id="zend.http.client.redirections.example-1">
@@ -40,7 +40,7 @@ $client->setConfig(array('strictredirects' => false);
 
         <para>
             Man kann immer die Anzahl der durchgeführten Umleitungen nach dem Senden einer Anfrage
-            durch Verwendung der getRedirectionsCount() Methoden erhalten.
+            durch Verwendung der Methode getRedirectionsCount() erhalten.
         </para>
     </sect2>
 
@@ -50,27 +50,27 @@ $client->setConfig(array('strictredirects' => false);
         <para>
             <classname>Zend_Http_Client</classname> stellt eine einfache Schnittstelle zum
             Hinzufügen von Cookies zu einer Anfrage bereit, so dass keine direkten Header
-            Änderungen notwendig sind. Dies wird durch Verwendung der setCookie() Methode erledigt.
+            Änderungen notwendig sind. Dies wird durch Verwendung der Methode setCookie() erledigt.
             Diese Methode kann auf mehrere Arten verwendet werden:
 
             <example id="zend.http.client.cookies.example-1">
                 <title>Cookies setzen durch Verwendung von setCookie()</title>
 
                 <programlisting language="php"><![CDATA[
-// Ganz einfach: durch Übergabe von Namen und Wert für den Cookie
+// Ganz einfach: durch Übergabe von Namen und Wert für das Cookie
 $client->setCookie('flavor', 'chocolate chips');
 
 // Durch direktes Übergeben eines unverarbeiteten Cookie Strings (Name=Wert)
 // Beachte, dass der Wert bereits URL kodiert sein muss
 $client->setCookie('flavor=chocolate%20chips');
 
-// Durch Übergabe eins Zend_Http_Cookie Objekts
+// Durch Übergabe eines Zend_Http_Cookie-Objekts
 $cookie = Zend_Http_Cookie::fromString('flavor=chocolate%20chips');
 $client->setCookie($cookie);
 ]]></programlisting>
             </example>
 
-            Für weitere Informationen über <classname>Zend_Http_Cookie</classname> Objekte, siehe
+            Für weitere Informationen über <classname>Zend_Http_Cookie</classname>-Objekte, siehe
             <link linkend="zend.http.cookies">diesen Abschnitt</link>.
         </para>
 
@@ -78,7 +78,7 @@ $client->setCookie($cookie);
             <classname>Zend_Http_Client</classname> stellt außerdem die Möglichkeiten für "Cookie
             Stickiness" bereit - das bedeutet, dass der Client intern alle gesendeten und erhaltenen
             Cookies speichert und bei nachfolgenden Anfragen automatisch wieder mit sendet. Dies ist
-            z.B. nützlich, wenn man sich bei einer entfernten Site zuerst einloggen muss und einen
+            z.B. nützlich, wenn man sich bei einer entfernten Site zuerst einloggen muss und ein
             Authentifizierungs- oder Session-Cookie erhält, bevor man weitere Anfragen versenden
             kann.
 
@@ -96,7 +96,7 @@ $client->setParameterPost('password', '1337');
 $client->request('POST');
 
 // Die Cookie Jar speichert die Cookies automatisch in der Antwort
-// wie z.B. ein Session ID Cookie.
+// wie z.B. ein Session-ID Cookie.
 
 // Nun können wir die nächste Anfrage senden - die gespeicherten Cookies
 // werden automatisch mit gesendet
@@ -105,7 +105,7 @@ $client->request('GET');
 ]]></programlisting>
             </example>
 
-            Für weitere Informationen über die <classname>Zend_Http_CookieJar</classname> Klasse,
+            Für weitere Informationen über die Klasse <classname>Zend_Http_CookieJar</classname>,
             siehe <link linkend="zend.http.cookies.cookiejar">diesen Abschnitt</link>.
         </para>
     </sect2>
@@ -114,7 +114,7 @@ $client->request('GET');
         <title>Setzen von individuellen Anfrageheadern</title>
 
         <para>
-            Das Setzen von individuellen Headern kann durch Verwendung der setHeaders() Methode
+            Das Setzen von individuellen Headern kann durch Verwendung der Methode setHeaders()
             erledigt werden. Diese Methode ist sehr facettenreich und kann auf verschiedene Arten
             verwendet werden, wie das folgende Beispiel zeigt:
 
@@ -128,7 +128,7 @@ $client->setHeaders('Host', 'www.example.com');
 // Ein anderer Weg um genau das Gleiche zu erreichen
 $client->setHeaders('Host: www.example.com');
 
-// Setzen von verschiedenen Werten für den selben Header
+// Setzen von verschiedenen Werten für denselben Header
 // (besonders für Cookie Header nützlich):
 $client->setHeaders('Cookie', array(
     'PHPSESSID=1234567890abcdef1234567890abcdef',
@@ -143,7 +143,7 @@ $client->setHeaders('Cookie', array(
             Übergabe eines Array mit Headern als einzigen Parameter verwendet werden:
 
             <example id="zend.http.client.custom_headers.example-2">
-                <title>Setzen eines mehreren individuellen Anfrageheaders</title>
+                <title>Setzen von mehreren individuellen Anfrageheaders</title>
 
                 <programlisting language="php"><![CDATA[
 // Setzen von mehreren Headern, vorherige werden überschrieben
@@ -166,21 +166,21 @@ $client->setHeaders(array(
         <title>Dateiuploads</title>
 
         <para>
-            Man kann Dateien über <acronym>HTTP</acronym> hochladen, indem man die setFileUpload
-            Methode verwendet. Diese Methode nimmt einen Dateinamen als ersten Parameter, einen
+            Man kann Dateien über <acronym>HTTP</acronym> hochladen, indem man die Methode
+            setFileUpload verwendet. Diese Methode nimmt einen Dateinamen als ersten Parameter, einen
             Formularnamen als zweiten Parameter und Daten als einen dritten, optionalen Parameter
             entgegen. Wenn der dritte Parameter <constant>NULL</constant> ist, wird angenommen, dass
-            der erste Dateinamen Parameter auf eine echte Datei auf der Platte verweist, und
+            der erste Dateinamen-Parameter auf eine echte Datei auf der Platte verweist, und
             <classname>Zend_Http_Client</classname> wird versuchen die Datei zu lesen und
-            hochzuladen. Wenn der Daten Parameter nicht <constant>NULL</constant> ist, wird der
-            erste Dateinamen Parameter als der Dateiname versendet, aber die Datei muss nicht
-            wirklich auf der Platte existieren. Der zweite Formularnamen Parameter wird immer
-            benötigt und ist gleichbedeutend mit dem "name" Attribut eines &gt;input&lt; Tags, wenn
-            die Datei durch ein <acronym>HTML</acronym> Formular hochgeladen worden ist. Ein vierter
+            hochzuladen. Wenn der Daten-Parameter nicht <constant>NULL</constant> ist, wird der
+            erste Dateinamen-Parameter als der Dateiname versendet, aber die Datei muss nicht
+            wirklich auf der Platte existieren. Der zweite Formularnamen-Parameter wird immer
+            benötigt und ist gleichbedeutend mit dem Attribut "name" eines &gt;input&lt; Tags, wenn
+            die Datei durch ein <acronym>HTML</acronym>-Formular hochgeladen worden ist. Ein vierter
             optionaler Parameter gibt den Content-type der Datei an. Wenn er nicht angegeben wird,
             liest <classname>Zend_Http_Client</classname> die Datei von der Platte und verwendet die
-            mime_content_type Funktion, um den Content-type der Datei zu erraten, wenn er verfügbar
-            ist. Auf jeden Fall ist der Standard MIME Typ 'application/octet-stream'.
+            Funktion mime_content_type, um den Content-type der Datei zu erraten, wenn er verfügbar
+            ist. Auf jeden Fall ist der Standard-MIME-Typ 'application/octet-stream'.
 
             <example id="zend.http.client.file_uploads.example-1">
                 <title>Verwendung von setFileUpload um Dateien hochzuladen</title>
@@ -209,27 +209,27 @@ $client->request('POST');
             <title>Dateien hochladen</title>
 
             <para>
-                Beim Hochladen von Dateien wird der Content-type der <acronym>HTTP</acronym> Anfrage
+                Beim Hochladen von Dateien wird der Content-type der <acronym>HTTP</acronym>-Anfrage
                 automatisch auf 'multipart/form-data' gesetzt. Man sollte beachten, dass man eine
-                POST oder PUT Anfrage absenden muss, um Dateien hochzuladen. Die meisten Server
+                POST- oder PUT-Anfrage absenden muss, um Dateien hochzuladen. Die meisten Server
                 werden den Hauptteil der Anfrage bei anderen Anfragetypen ignorieren.
             </para>
         </note>
     </sect2>
 
     <sect2 id="zend.http.client.raw_post_data">
-        <title>Unverarbeitete POST Daten versenden</title>
+        <title>Unverarbeitete POST-Daten versenden</title>
 
         <para>
-            Man kann <classname>Zend_Http_Client</classname> verwenden, um mit der setRawData()
-            Methode unverarbeitete POST Daten zu versenden. Diese Methode nimmt zwei Parameter
+            Man kann <classname>Zend_Http_Client</classname> verwenden, um mit der Methode 
+            setRawData() unverarbeitete POST-Daten zu versenden. Diese Methode nimmt zwei Parameter
             entgegen: der erste ist die im Anfrage Hauptteil zu versendenen Daten. Der zweite
             optionale Parameter ist der Content-type der Daten. Obwohl dieser Parameter optional
             ist, sollte man ihn normalerweise vor dem Absenden der Anfrage setzen - entweder durch
             Verwendung von setRawData() oder durch eine andere Methode: setEncType().
 
             <example id="zend.http.client.raw_post_data.example-1">
-                <title>Unverarbeitete POST Daten versenden</title>
+                <title>Unverarbeitete POST-Daten versenden</title>
 
                 <programlisting language="php"><![CDATA[
 $xml = '<book>' .
@@ -240,42 +240,42 @@ $xml = '<book>' .
 
 $client->setRawData($xml, 'text/xml')->request('POST');
 
-// Ein anderer Weg, um das selbe zu tun:
+// Ein anderer Weg, um dasselbe zu tun:
 $client->setRawData($xml)->setEncType('text/xml')->request('POST');
 ]]></programlisting>
             </example>
 
-            Die Daten sollten auf der Serverseite über die <acronym>PHP</acronym> Variable
+            Die Daten sollten auf der Serverseite über die <acronym>PHP</acronym>-Variable
             $HTTP_RAW_POST_DATA oder über den php://input stream verfügbar sein.
         </para>
 
         <note>
-            <title>Unverarbeitete POST Daten verwenden</title>
+            <title>Unverarbeitete POST-Daten verwenden</title>
 
             <para>
-                Das Setzen von unverarbeiteten POST Daten für eine Anfrage überschreibt jeden POST
-                Parameter oder Dateiuploads. Man sollte nicht beides in der selben Anfrage
+                Das Setzen von unverarbeiteten POST-Daten für eine Anfrage überschreibt jeden
+                POST-Parameter oder Dateiuploads. Man sollte nicht beides in derselben Anfrage
                 verwenden. Es ist zu beachten, dass die meisten Server den Hauptteil der Anfrage
-                ignorieren, wenn keine POST Anfrage gesendet wird.
+                ignorieren, wenn keine POST-Anfrage gesendet wird.
             </para>
         </note>
     </sect2>
 
     <sect2 id="zend.http.client.http_authentication">
-        <title>HTTP Authentifizierung</title>
+        <title>HTTP-Authentifizierung</title>
 
         <para>
             Derzeit unterstützt <classname>Zend_Http_Client</classname> nur die Basis
-            <acronym>HTTP</acronym> Authentifizierung. Diese Funktion kann durch Verwendung der
-            <methodname>setAuth()</methodname> Methode oder durch Spezifikation von Benutzername und
-            Passwort in der URI genutzt werden. Die <methodname>setAuth()</methodname> Methode nimmt
+            <acronym>HTTP</acronym>-Authentifizierung. Diese Funktion kann durch Verwendung der
+            Methode <methodname>setAuth()</methodname> oder durch Spezifikation von Benutzername und
+            Passwort in der URI genutzt werden. Die Methode <methodname>setAuth()</methodname> nimmt
             3 Parameter entgegen: den Benutzernamen, das Passwort und einen optionalen
-            Authentifizierungstyp Parameter. Wie gesagt, wird derzeit nur die Basis
+            Authentifizierungstyp-Parameter. Wie gesagt, wird derzeit nur die Basis
             Authentifizierung unterstützt (Unterstützung für eine Digest Authentifizierung ist
             geplant).
 
             <example id="zend.http.client.http_authentication.example-1">
-                <title>Setzen von Benutzer und Password für eine HTTP Authentifizierung</title>
+                <title>Setzen von Benutzer und Passwort für eine HTTP Authentifizierung</title>
 
                 <programlisting language="php"><![CDATA[
 // Verwende die Basis Authentifizierung
@@ -292,39 +292,39 @@ $client->setUri('http://christer:secret@example.com');
     </sect2>
 
     <sect2 id="zend.http.client.multiple_requests">
-        <title>Versenden mehrerer Anfragen mit dem selben Client</title>
+        <title>Versenden mehrerer Anfragen mit demselben Client</title>
 
         <para>
             <classname>Zend_Http_Client</classname> wurde zusätzlich besonders dafür entwickelt, um
-            mehrere, aufeinander folgende Abfragen durch das selbe Objekt verarbeiten zu können.
+            mehrere, aufeinander folgende Abfragen durch dasselbe Objekt verarbeiten zu können.
             Dies ist nützlich, wenn z.B. ein Skript es erfordert, Daten von verschiedenen Stellen
-            abzurufen, oder wenn eine spezielle <acronym>HTTP</acronym> Ressource das Einloggen und
+            abzurufen, oder wenn eine spezielle <acronym>HTTP</acronym>-Ressource das Einloggen und
             Erhalten eines Session Cookies erfordert.
         </para>
 
         <para>
-            Beim Ausführen mehrere Anfrage an den selben Host, wird es besonders empfohlen, den
+            Beim Ausführen mehrere Anfrage an denselben Host, wird es besonders empfohlen, den
             Konfigurationsschalter 'keepalive' zu aktivieren. Wenn der Server keep-alive
             Verbindungen unterstützt, wird auf diesem Weg die Verbindung zum Server nur beendet,
-            sobald alle Anfragen abgeschlossen sind und das Client Objekt zerstört wird. Dies
-            verhindert den Overhead beim Öffnen und Schließen von <acronym>TCP</acronym>
-            Verbindungen zum Server.
+            sobald alle Anfragen abgeschlossen sind und das Client-Objekt zerstört wird. Dies
+            verhindert den Overhead beim Öffnen und Schließen von 
+            <acronym>TCP</acronym>-Verbindungen zum Server.
         </para>
 
         <para>
-            Wenn man verschiedene Anfragen mit dem selben Client durchführt, aber sicherstellen
+            Wenn man verschiedene Anfragen mit demselben Client durchführt, aber sicherstellen
             möchte, dass alle anfragespezifischen Parameter entfernt werden, sollte man die
-            resetParameters() Methode verwenden. Dies stellt sicher, dass <constant>GET</constant>
-            und POST Parameter, Anfragehauptteil und anfragespezifischen Header zurückgesetzt und
+            Methode resetParameters() verwenden. Dies stellt sicher, dass <constant>GET</constant>-
+            und POST-Parameter, Anfragehauptteil und anfragespezifischen Header zurückgesetzt und
             nicht bei der nächsten Anfrage wiederverwendet werden.
         </para>
 
         <note>
-            <title>Parameter zurück setzen</title>
+            <title>Parameter zurücksetzen</title>
 
             <para>
                 Bitte beachten, dass Header, die nicht anfragespezifisch sind, standardmäßig nicht
-                zurück gesetzt werden, wenn die <methodname>resetParameters()</methodname> Methode
+                zurückgesetzt werden, wenn die Methode <methodname>resetParameters()</methodname>
                 verwendet wird. Nur die 'Content-length' und 'Content-type' Header werden zurück
                 gesetzt. Dies erlaubt das Setzen und Vergessen von Headern wie 'Accept-language' und
                 'Accept-encoding'.
@@ -378,7 +378,7 @@ if (isset($_SESSION['cookiejar']) &&
     $client->request(Zend_Http_Client::POST);
 
     // Nun entferne die Parameter und setze die URI auf das Original
-    // (Bitte beachten, dass der Cookie, der vom Server gesetzt worden ist,
+    // (Bitte beachten, dass das Cookie, das vom Server gesetzt worden ist,
     // nun in der Dose ist)
     $client->resetParameters();
     $client->setUri('http://www.example.com/fetchdata.php');
@@ -393,25 +393,25 @@ $_SESSION['cookiejar'] = $client->getCookieJar();
     </sect2>
 
     <sect2 id="zend.http.client.streaming">
-        <title>Daten Streaming</title>
+        <title>Daten-Streaming</title>
 
         <para>
-            Standardmäßig akzeptiert <classname>Zend_Http_Client</classname> Daten als
-            <acronym>PHP</acronym> Strings und gibt diese auch zurück. Trotzdem sind in vielen
-            Fällen große Dateien zu Senden oder zu Empfangen. Diese im Speicher zu halten könnte
+            Standardmäßig akzeptiert <classname>Zend_Http_Client</classname>-Daten als
+            <acronym>PHP</acronym>-Strings und gibt diese auch zurück. Trotzdem sind in vielen
+            Fällen große Dateien zu Senden oder zu Empfangen. Diese im Speicher zu halten, könnte
             unnötig oder zu teuer sein. Für diese Fälle unterstützt
             <classname>Zend_Http_Client</classname> das Lesen von Daten aus Dateien (und generell
-            auch <acronym>PHP</acronym> Streams) und das Schreiben von Daten in Dateien (Streams).
+            auch <acronym>PHP</acronym>-Streams) und das Schreiben von Daten in Dateien (Streams).
         </para>
 
         <para>
             Um Streams für die Übergabe von Daten zu <classname>Zend_Http_Client</classname> zu
             verwenden, muss die Methode <methodname>setRawData()</methodname> verwendet werden,
-            wobei das Daten Argument eine Stream Ressource ist (z.B. das Ergebnis von
+            wobei das Daten-Argument eine Stream-Ressource ist (z.B. das Ergebnis von
             <methodname>fopen()</methodname>).
 
             <example id="zend.http.client.streaming.example-1">
-                <title>Senden von Dateien zum HTTP Server durch Streamen</title>
+                <title>Senden von Dateien zum HTTP-Server durch Streamen</title>
 
                 <programlisting language="php"><![CDATA[
 $fp = fopen("mybigfile.zip", "r");
@@ -421,15 +421,15 @@ $client->setRawData($fp, 'application/zip')->request('PUT');
         </para>
 
         <para>
-            Aktuell unterstützen nur PUT Anfragen das Senden von Streams zum <acronym>HTTP</acronym>
-            Server.
+            Aktuell unterstützen nur PUT-Anfragen das Senden von Streams zum
+            <acronym>HTTP</acronym>-Server.
         </para>
 
         <para>
             Um Daten vom Server als Stream zu Empfangen kann <methodname>setStream()</methodname>
-            verwendet werden. Das optionale Argument spezifiziert den Dateinamen unter dem die Daten
-            gespeichert werden. Wenn das Argument einfach nur <constant>TRUE</constant> ist
-            (Standard), wird eine temporäre Datei verwenden und gelöscht sobald das Antwort Objekt
+            verwendet werden. Das optionale Argument spezifiziert den Dateinamen, unter dem die
+            Daten gespeichert werden. Wenn das Argument einfach nur <constant>TRUE</constant> ist
+            (Standard), wird eine temporäre Datei verwendet und gelöscht, sobald das Antwort-Objekt
             zerstört wird. Wenn das Argument auf <constant>FALSE</constant> gesetzt wird, ist die
             Streaming-Funktionalität ausgeschaltet.
         </para>
@@ -438,15 +438,15 @@ $client->setRawData($fp, 'application/zip')->request('PUT');
             Wenn Streaming verwendet wird, gibt die Methode <methodname>request()</methodname> ein
             Objekt der Klasse <classname>Zend_Http_Client_Response_Stream</classname> zurück,
             welches zwei nützliche Methoden hat: <methodname>getStreamName()</methodname> gibt den
-            Namen der Datei zurück in welcher die Antwort gespeichert wird, und
-            <methodname>getStream()</methodname> gibt den Stream zurück von dem die Antwort gelesen
+            Namen der Datei zurück, in welcher die Antwort gespeichert wird, und
+            <methodname>getStream()</methodname> gibt den Stream zurück, von dem die Antwort gelesen
             werden könnte.
         </para>
 
         <para>
             Man kann die Antwort entweder in eine vordefinierte Datei schreiben, oder eine temporäre
-            Datei hierfür verwenden und Sie woanders hinsenden, oder Sie durch Verwendung von
-            regulären Streaming Funktionen an eine andere Datei Senden.
+            Datei hierfür verwenden und sie woanders hinsenden, oder sie durch Verwendung von
+            regulären Streaming-Funktionen an eine andere Datei senden.
 
             <example id="zend.http.client.streaming.example-2">
                 <title>Empfangen von Dateien vom HTTP Server durch Streamen</title>