[MANUAL] German:

 - added review

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

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

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!-- EN-Revision: 22743 -->
-<!-- Reviewed: no -->
+<!-- Reviewed: 22743 -->
 <sect1 id="zend.http.client.adapters">
     <title>Zend_Http_Client - Verbindungsadapter</title>
 
@@ -12,13 +12,13 @@
             Verbindungsadaptern. Der Verbindungsadapter ist das Objekt, welches für die Ausführung
             der aktuellen Verbindung zum Server sowie für das Schreiben der Anfragen und Lesen von
             Antworten verantwortlich ist. Dieser Verbindungsadapter kann ersetzt werden und man kann
-            den Standard Verbindungsadapter durch seinen eigenen Adapter erweitern, um ihn mit dem
-            selben Interface auf seine eigenen Bedürfnisse anzupassen, ohne dass man die gesamte
-            <acronym>HTTP</acronym> Client Klasse erweitern oder ersetzen muss.
+            den Standard-Verbindungsadapter durch seinen eigenen Adapter erweitern, um ihn mit
+            demselben Interface auf seine eigenen Bedürfnisse anzupassen, ohne dass man die gesamte
+            <acronym>HTTP</acronym> Client-Klasse erweitern oder ersetzen muss.
         </para>
 
         <para>
-            Derzeit stellt die <classname>Zend_Http_Client</classname> Klasse vier eingebaute
+            Derzeit stellt die <classname>Zend_Http_Client</classname>-Klasse vier eingebaute
             Verbindungsadapter bereit:
 
             <itemizedlist>
@@ -43,10 +43,10 @@
         </para>
 
         <para>
-            Der Verbindungsadapter für das <classname>Zend_Http_Client</classname> Objekt wird durch
-            Verwendung der 'adapter' Konfigurationsoption gesetzt. Beim Instanzieren des Client
-            Objektes kann man die 'adapter' Konfigurationsoption setzen mit einem String, der den
-            Adapternamen (z.B. 'Zend_Http_Client_Adapter_Socket') enthält, oder mit eine Variable,
+            Der Verbindungsadapter für das <classname>Zend_Http_Client</classname>-Objekt wird durch
+            Verwendung der Konfigurationsoption 'adapter' gesetzt. Beim Instanzieren des Client
+            Objektes kann man die Konfigurationsoption 'adapter' mit einem String setzen, der den
+            Adapternamen (z.B. 'Zend_Http_Client_Adapter_Socket') enthält, oder mit einer Variablen,
             die ein Adapterobjekt (z.B. <command>new Zend_Http_Client_Adapter_Test</command>)
             enthält. Man kann den Adapter auch danach setzen, indem man die
             <classname>Zend_Http_Client->setConfig()</classname> Methode verwendet.
@@ -54,22 +54,22 @@
     </sect2>
 
     <sect2 id="zend.http.client.adapters.socket">
-        <title>Der Socket Adapter</title>
+        <title>Der Socket-Adapter</title>
 
         <para>
             Der Standard-Adapter ist <classname>Zend_Http_Client_Adapter_Socket</classname>.
-            Dieser wird benutzt, wenn kein anderer angegeben wird. Der Socket Adapter benutzt die
-            native <acronym>PHP</acronym> Funktion fsockopen(), um die Verbindung aufzubauen, dafür
-            werden keine besonderen Extensions oder Einstellungen benötigt.
+            Dieser wird benutzt, wenn kein anderer angegeben wird. Der Socket-Adapter benutzt die
+            native <acronym>PHP</acronym>-Funktion fsockopen(), um die Verbindung aufzubauen, dafür
+            werden keine besonderen Erweiterungen oder Einstellungen benötigt.
         </para>
 
         <para>
-            Der Socket Adapter erlaubt verschiedene zusätzliche Konfigurations Optionen die gesetzt
+            Der Socket-Adapter erlaubt verschiedene zusätzliche Konfigurationsoptionen, die gesetzt
             werden können durch Verwendung von <classname>Zend_Http_Client->setConfig()</classname>
             oder deren Übergabe an den Konstruktor des Clients.
 
             <table id="zend.http.client.adapter.socket.configuration.table">
-                <title>Zend_Http_Client_Adapter_Socket Konfigurations Parameter</title>
+                <title>Zend_Http_Client_Adapter_Socket Konfigurationsparameter</title>
 
                 <tgroup cols="4">
                     <thead>
@@ -86,7 +86,7 @@
                             <entry>persistent</entry>
 
                             <entry>
-                                Ob eine persistente <acronym>TCP</acronym> Verbindung verwendet
+                                Ob eine persistente <acronym>TCP</acronym>-Verbindung verwendet
                                 werden soll oder nicht
                             </entry>
 
@@ -96,7 +96,7 @@
 
                         <row>
                             <entry>ssltransport</entry>
-                            <entry>Der Transport Layer für SSL (z.B. 'sslv2', 'tls')</entry>
+                            <entry>Der Transport-Layer für SSL (z.B. 'sslv2', 'tls')</entry>
                             <entry>string</entry>
                             <entry>ssl</entry>
                         </row>
@@ -106,7 +106,7 @@
 
                             <entry>
                                 Pfad zu einem <acronym>PEM</acronym> verschlüsselten
-                                <acronym>SSL</acronym> Zertifikat
+                                <acronym>SSL</acronym>-Zertifikat
                             </entry>
 
                             <entry>string</entry>
@@ -123,18 +123,18 @@
                             <entry>string</entry>
                             <entry><constant>NULL</constant></entry>
                         </row>
-
-                        <row>
-                            <entry>sslusecontext</entry>
-
+
+                        <row>
+                            <entry>sslusecontext</entry>
+
                             <entry>
-                                Aktiviert das Proxy Verbindungen SSL verwenden sogar wenn die Proxy
-                                Verbindung selbst es nicht tut.
-                            </entry>
-
-                            <entry>boolean</entry>
-                            <entry><constant>FALSE</constant></entry>
-                        </row>
+                                Aktiviert, dass Proxy Verbindungen SSL verwenden sogar wenn die Proxy
+                                Verbindung selbst es nicht tut.
+                            </entry>
+
+                            <entry>boolean</entry>
+                            <entry><constant>FALSE</constant></entry>
+                        </row>
                     </tbody>
                 </tgroup>
             </table>
@@ -143,24 +143,24 @@
                 <title>Persistente TCP Verbindungen</title>
 
                 <para>
-                    Die Verwendung persistenter <acronym>TCP</acronym> Verbindungen kann
-                    <acronym>HTTP</acronym> Anfragen potentiell schneller machen - aber in den
+                    Die Verwendung persistenter <acronym>TCP</acronym>-Verbindungen kann
+                    <acronym>HTTP</acronym>-Anfragen potentiell schneller machen - aber in den
                     meisten Fällen, wird es nur einen kleinen positiven Effekt haben und könnte den
-                    <acronym>HTTP</acronym> Server überladen zu dem man sich verbindet.
+                    <acronym>HTTP</acronym>-Server überlasten, zu dem man sich verbindet.
                 </para>
 
                 <para>
-                    Es wird empfohlen persistente <acronym>TCP</acronym> Verbindungen nur dann zu
-                    verwenden wenn man sich zu dem gleichen Server sehr oft verbindet, und man
-                    sicher ist das der Server eine große Anzahl an gleichzeitigen Verbindungen
-                    behandeln kann. In jedem Fall wird empfohlen das der Effekt von persistenten
+                    Es wird empfohlen persistente <acronym>TCP</acronym>-Verbindungen nur dann zu
+                    verwenden, wenn man sich zu dem gleichen Server sehr oft verbindet, und man
+                    sicher ist, dass der Server eine große Anzahl an gleichzeitigen Verbindungen
+                    behandeln kann. In jedem Fall wird empfohlen, dass der Effekt von persistenten
                     Verbindungen auf beiden, der Geschwindigkeit des Clients und dem Serverload
-                    gemessen wird bevor diese Option verwendet wird.
+                    gemessen wird, bevor diese Option verwendet wird.
                 </para>
 
                 <para>
                     Zusätzlich, wenn persistente Verbindungen verwendet werden, sollte man
-                    Keep-Alive <acronym>HTTP</acronym> Anfragen aktivieren wie im <link
+                    Keep-Alive <acronym>HTTP</acronym>-Anfragen aktivieren wie im <link
                         linkend="zend.http.client.configuration">Abschnitt für Konfiguration</link>
                     beschrieben - andernfalls werden persistente Verbindungen nur wenig oder gar
                     keinen Effekt haben.
@@ -177,10 +177,10 @@
                 </para>
 
                 <para>
-                    Wärend die Standard <acronym>SSL</acronym> Einstellungen für die meisten
-                    Anwendungen funktionieren, kann es notwendig sein diese zu Ändern wenn der
-                    Server zu dem man sich verbindet ein spezielles Client Setup benötigt. Wenn dem
-                    so ist, sollte man das Kapitel über <acronym>SSL</acronym> Transport Layer und
+                    Wärend die Standard <acronym>SSL</acronym>-Einstellungen für die meisten
+                    Anwendungen funktionieren, kann es notwendig sein diese zu ändern, wenn der
+                    Server zu dem man sich verbindet ein spezielles Client-Setup benötigt. Wenn dem
+                    so ist, sollte man das Kapitel über <acronym>SSL</acronym>-Transport-Layer und
                     Optionen lesen das <ulink
                         url="http://www.php.net/manual/en/transports.php#transports.inet">hier</ulink>
                     zu finden ist.
@@ -189,7 +189,7 @@
         </para>
 
         <example id="zend.http.client.adapters.socket.example-1">
-            <title>Den Stream-Typen für eine HTTPS Verbindung einstellen</title>
+            <title>Den Stream-Typen für eine HTTPS-Verbindung einstellen</title>
 
             <programlisting language="php"><![CDATA[
 // Konfigurationsparameter setzen
@@ -223,9 +223,9 @@ $response = $client->request();
                 darunterliegenden <ulink
                     url="http://php.net/manual/de/stream.contexts.php">Stream Kontext</ulink> der
                 für die Verbindung zum entfernten Server verwendet wird. Das erlaubt es
-                Benutzern spezielle Optionen und Parameter an den <acronym>TCP</acronym> Stream zu
-                übergeben und an den <acronym>SSL</acronym> Wrapper im Falle einer
-                <acronym>HTTPS</acronym> Verbindung.
+                Benutzern spezielle Optionen und Parameter an den <acronym>TCP</acronym>-Stream zu
+                übergeben und an den <acronym>SSL</acronym>-Wrapper im Falle einer
+                <acronym>HTTPS</acronym>-Verbindung.
             </para>
 
             <para>
@@ -308,11 +308,11 @@ echo $opts['ssl']['peer_certificate'];
 
             <note>
                 <para>
-                    Es ist zu beachten das alle Stream Kontext Optionen gesetzt sein müssen bevor
+                    Es ist zu beachten das alle Stream Kontext Optionen gesetzt sein müssen, bevor
                     der Adapter Anfragen durchführt. Wenn kein Kontext gesetzt ist bevor
-                    <acronym>HTTP</acronym> Anfragen mit dem Socket Adapter durchgeführt werden,
+                    <acronym>HTTP</acronym>-Anfragen mit dem Socket Adapter durchgeführt werden,
                     wird ein standardmäßiger Stream Kontext erstellt. Auf diese Kontext Ressource
-                    kann zugegriffen werden nachdem Anfragen durchgeführt werden indem die
+                    kann zugegriffen werden, nachdem Anfragen durchgeführt werden, indem die
                     <methodname>getStreamContext()</methodname> Methode verwendet wird.
                 </para>
             </note>
@@ -324,8 +324,8 @@ echo $opts['ssl']['peer_certificate'];
 
         <para>
             Der Proxy Adapter <classname>Zend_Http_Client_Adapter_Proxy</classname> verhält sich wie
-            der standard <classname>Zend_Http_Client_Adapter_Socket</classname>, mit dem
-            Unterschied, dass die Verbindung über einen <acronym>HTTP</acronym> Proxy-Server
+            der Standard-<classname>Zend_Http_Client_Adapter_Socket</classname>, mit dem
+            Unterschied, dass die Verbindung über einen <acronym>HTTP</acronym>-Proxy-Server
             aufgebaut wird statt den Server direkt zu kontaktieren. Das erlaubt die Verwendung von
             <classname>Zend_Http_Client</classname> hinter Proxy Servern - was manchmal wegen der
             Sicherheit und Geschwindigkeit notwendig ist.
@@ -454,11 +454,11 @@ $client = new Zend_Http_Client('http://www.example.com', $config);
         <para>
             cURL ist eine Standard <acronym>HTTP</acronym> Client Bibliothek die mit vielen
             Betriebssystemen ausgeliefert wird, und kann in <acronym>PHP</acronym> über die cURL
-            Erweiterung verwendet werden. Sie bietet Funktionalitäten für viele spezielle Fälle die
-            für einen <acronym>HTTP</acronym> Client auftreten können und machen sie zu einer
-            perfekten Wahl für einen <acronym>HTTP</acronym> Adapter. Sie unterstützt sichere
+            Erweiterung verwendet werden. Sie bietet Funktionalitäten für viele spezielle Fälle, die
+            für einen <acronym>HTTP</acronym>-Client auftreten können und machen sie zu einer
+            perfekten Wahl für einen <acronym>HTTP</acronym>-Adapter. Sie unterstützt sichere
             Verbindungen, Proxies, alle Arten von Authentifizierungsmechanismen und glänzt in
-            Anwendungen die große Dateien zwischen Servern bewegen müssen.
+            Anwendungen, die große Dateien zwischen Servern bewegen müssen.
         </para>
 
         <example id="zend.http.client.adapters.curl.example-1">
@@ -474,7 +474,7 @@ $client = new Zend_Http_Client($uri, $config);
         </example>
 
         <para>
-            Standardmäßig ist der cURL Adapter so konfiguriert das er sich genauso wie der
+            Standardmäßig ist der cURL Adapter so konfiguriert, dass er sich genauso wie der
             Socket Adapter verhält und er akzeptiert auch die gleichen Konfigurationsparameter wie
             die Socket und Proxy Adapter. Man kann die cURL Optionen entweder durch den
             'curloptions' Schlüssel im Konstruktor des Adapters, oder durch den Aufruf von
@@ -514,27 +514,27 @@ $client->request("PUT");
         <title>Der Test Adapter</title>
 
         <para>
-            Manchmal ist es sehr schwer Code zu testen, der von <acronym>HTTP</acronym> Verbindungen
+            Manchmal ist es sehr schwer Code zu testen, der von <acronym>HTTP</acronym>-Verbindungen
             abhängig ist. Zum Beispiel verlangt das Testen einer Applikation, die einen
-            <acronym>RSS</acronym> Feed von einem fremden Server anfordert, eine Netzwerkverbindung,
+            <acronym>RSS</acronym>-Feed von einem fremden Server anfordert, eine Netzwerkverbindung,
             die nicht immer verfügbar ist.
         </para>
 
         <para>
-            Aus diesem Grund wird der <classname>Zend_Http_Client_Adapter_Test</classname> Adapter
+            Aus diesem Grund wird der <classname>Zend_Http_Client_Adapter_Test</classname>-Adapter
             bereit gestellt. Man kann seine eigenen Applikationen schreiben, um
             <classname>Zend_Http_Client</classname> zu verwenden, und nur zu Testzwecken, z.B. in
-            der Unit Test Suite, den Standardadapter durch den Testadapter (ein Mock Objekt)
+            der UnitTest-Suite, den Standardadapter durch den Testadapter (ein Mock-Objekt)
             austauschen, um Tests ohne direkte Serverbindungen auszuführen.
         </para>
 
         <para>
-            Der <classname>Zend_Http_Client_Adapter_Test</classname> Adapter stellt die zusätzliche
+            Der <classname>Zend_Http_Client_Adapter_Test</classname>-Adapter stellt die zusätzliche
             Methode setResponse() bereit. Diese Methode nimmt einen Parameter entgegen, der eine
-            <acronym>HTTP</acronym> Antwort entweder als Text oder als
-            <classname>Zend_Http_Response</classname> Objekt repräsentiert. Einmal eingerichtet,
+            <acronym>HTTP</acronym>-Antwort entweder als Text oder als
+            <classname>Zend_Http_Response</classname>-Objekt repräsentiert. Einmal eingerichtet,
             wird der Testadapter immer diese Antwort zurückgeben, ohne tatsächlich eine
-            <acronym>HTTP</acronym> Anfrage auszuführen.
+            <acronym>HTTP</acronym>-Anfrage auszuführen.
         </para>
 
         <example id="zend.http.client.adapters.test.example-1">
@@ -568,7 +568,7 @@ $response = $client->request('GET');
         </example>
 
         <para>
-            Das obige Beispiel zeigt, wie man einen <acronym>HTTP</acronym> Client voreinstellen
+            Das obige Beispiel zeigt, wie man einen <acronym>HTTP</acronym>-Client voreinstellen
             kann, damit er die benötigte Antwort zurückgibt. Danach kann man mit den Testen des
             eigenen Codes weiter machen, ohne von einer Netzwerkverbindung, der Serverantwort, etc.
             abhängig zu sein. In diesem Fall würde der Test mit der Prüfung fortfahren, wie die
@@ -577,8 +577,8 @@ $response = $client->request('GET');
 
         <para>
             Manchmal erfordert ein einziger Methoden-Aufruf mehrere <acronym>HTTP</acronym>
-            Übertragungen. In diesem Fall ist es nicht möglich setResponse() alleine zu verwenden
-            weil es keine Möglichkeit gibt die nächste Antwort zu setzen die das Programm benötigt
+            Übertragungen. In diesem Fall ist es nicht möglich, setResponse() alleine zu verwenden
+            weil es keine Möglichkeit gibt, die nächste Antwort zu setzen, die das Programm benötigt,
             bevor es zum Aufrufer zurückkommt.
         </para>
 
@@ -613,15 +613,15 @@ $adapter->addResponse(
     '  <body><p>...</p></body>' .
     '</html>');
 
-// Das $client Objekt kann jetzt zu testzwecken herangezogen werden,
+// Das $client Objekt kann jetzt zu Testzwecken herangezogen werden,
 // indem es wie ein normales Client-Objekt benutzt wird.
 ]]></programlisting>
         </example>
 
         <para>
-            Die setResponse() Methode löscht alle Antworten im Buffer von
-            <classname>Zend_Http_Client_Adapter_Test</classname> und setzt die erste Antwort
-            die zurückgegeben wird. Die addResponse() Methode fügt dann weitere Antworten
+            Die Methode setResponse() löscht alle Antworten im Buffer von
+            <classname>Zend_Http_Client_Adapter_Test</classname> und setzt die erste Antwort,
+            die zurückgegeben wird. Die Methode addResponse() fügt dann weitere Antworten
             sukzessiv hinzu.
         </para>
 
@@ -635,22 +635,22 @@ $adapter->addResponse(
             Das oben angeführte Beispiel kann dazu benutzt werden, um die Reaktion
             der eigenen Anwendung auf einen 302 Redirect (Weiterleitung) zu testen.
             Abhängig von Ihrer Anwendung, kann es gewollt oder nicht gewollt sein,
-            dass dem Redirect gefolgt wird. In unserem Beispiel erwarten wir das der
-            Umleitung gefolgt wird und wir konfigurieren den Test Adapter um uns zu helfen das
-            zu Testen. Die ursprüngliche 302 Antwort wird mit der setResponse() Methode gesetzt
-            und die 200 Antwort welche als nächstes zurückzugeben ist wird mit der
-            addResponse() Methode hinzugefügt. Nachdem der Test Adapter konfiguriert ist, wird
-            der <acronym>HTTP</acronym> Client der den Adapter enthält unter test in das eigene
+            dass dem Redirect gefolgt wird. In unserem Beispiel erwarten wir, dass der
+            Umleitung gefolgt wird und wir konfigurieren den Test-Adapter um uns zu helfen das
+            zu Testen. Die ursprüngliche 302 Antwort wird mit der Methode setResponse() gesetzt
+            und die 200 Antwort, welche als nächstes zurückzugeben ist, wird mit der
+            Methode addResponse() hinzugefügt. Nachdem der Test-Adapter konfiguriert ist, wird
+            der <acronym>HTTP</acronym>-Client, der den Adapter enthält unter test in das eigene
             Objekt injiziert und sein Verhalten getestet.
         </para>
 
         <para>
-            Wenn man will das der Adapter auf Wunsch fehlschlägt kann man
+            Wenn man will, dass der Adapter auf Wunsch fehlschlägt, kann man
             <methodname>setNextRequestWillFail($flag)</methodname> verwenden. Diese Methode lässt
-            den Nächsten Aufruf von <methodname>connect()</methodname> eine
-            <classname>Zend_Http_Client_Adapter_Exception</classname> Exception geworfen. Das kann
-            dann nützlich sein wenn die eigene Anwendung Inhalte von einer externen Seite cacht
-            (im Falle das die Seite ausfällt) und man dieses Feature testen will.
+            den nächsten Aufruf von <methodname>connect()</methodname> eine
+            <classname>Zend_Http_Client_Adapter_Exception</classname>-Exception werfen. Das kann
+            dann nützlich sein, wenn die eigene Anwendung Inhalte von einer externen Seite cacht
+            (im Falle, dass die Seite ausfällt) und man dieses Feature testen will.
         </para>
 
         <example id="zend.http.client.adapters.test.example-3">
@@ -663,7 +663,7 @@ $client = new Zend_Http_Client('http://www.example.com', array(
     'adapter' => $adapter
 ));
 
-// Erzwingen das die nächste Anfrage mit einer Exception fehlschlägt
+// Erzwingen, dass die nächste Anfrage mit einer Exception fehlschlägt
 $adapter->setNextRequestWillFail(true);
 
 try {
@@ -684,8 +684,8 @@ try {
 
         <para>
             Es ist möglich eigene Verbindungs-Adapter zu schreiben, die spezielle
-            Bedürfnisse, wie persistente Sockets oder gecachte Verbindungen, abdecken.
-            Diese können dann, wie gewohnt in der eigenen Anwendung benutzt werden können.
+            Bedürfnisse, wie persistente Sockets oder gecachte Verbindungen abdecken.
+            Diese können dann wie gewohnt in der eigenen Anwendung benutzt werden.
         </para>
 
         <para>