|
|
@@ -1,6 +1,6 @@
|
|
|
<?xml version="1.0" encoding="UTF-8"?>
|
|
|
<!-- EN-Revision: 22743 -->
|
|
|
-<!-- Reviewed: no -->
|
|
|
+<!-- Reviewed: 22743 -->
|
|
|
<sect1 id="zend.http.client">
|
|
|
<title>Einführung</title>
|
|
|
|
|
|
@@ -8,10 +8,10 @@
|
|
|
<classname>Zend_Http_Client</classname> stellt eine einfache Schnittstelle für das
|
|
|
Durchführen von Hyper-Text Transfer Protocol (HTTP) Anfragen.
|
|
|
<classname>Zend_Http_Client</classname> unterstützt die meisten einfachen Funktionen, die
|
|
|
- man von einem <acronym>HTTP</acronym> Client erwartet, sowie einige komplexere Funktionen,
|
|
|
- wie z.B. <acronym>HTTP</acronym> Authentifizierung und Dateiuploads. Erfolgreiche Anfragen
|
|
|
+ man von einem <acronym>HTTP</acronym>-Client erwartet, sowie einige komplexere Funktionen,
|
|
|
+ wie z.B. <acronym>HTTP</acronym>-Authentifizierung und Dateiuploads. Erfolgreiche Anfragen
|
|
|
(und die meisten nicht erfolgreichen ebenfalls) liefern ein
|
|
|
- <classname>Zend_Http_Response</classname> Objekt zurück, welches den Zugriff auf die Header
|
|
|
+ <classname>Zend_Http_Response</classname>-Objekt zurück, welches den Zugriff auf die Header
|
|
|
und den Hauptteil der Antwort ermöglichen (siehe <link linkend="zend.http.response">diesen
|
|
|
Abschnitt</link>).
|
|
|
</para>
|
|
|
@@ -21,10 +21,10 @@
|
|
|
|
|
|
<para>
|
|
|
Der Klassenkonstruktor akzeptiert optional eine URL als seinen ersten Parameter (kann
|
|
|
- entweder ein String oder ein <classname>Zend_Uri_Http</classname> Objekt sein) und ein
|
|
|
- Array oder <classname>Zend_Config</classname> Objekt welches Konfigurationsparameter
|
|
|
- enthält. Beides kann ausgelassen und später durch Verwendung der setUri() and
|
|
|
- setConfig() Methoden gesetzt werden.
|
|
|
+ entweder ein String oder ein <classname>Zend_Uri_Http</classname>-Objekt sein) und ein
|
|
|
+ Array oder <classname>Zend_Config</classname>-Objekt, welches Konfigurationsparameter
|
|
|
+ enthält. Beides kann weggelassen und später durch Verwendung der Methoden setUri() und
|
|
|
+ setConfig() gesetzt werden.
|
|
|
|
|
|
<example id="zend.http.client.introduction.example-1">
|
|
|
<title>Ein Zend_Http_Client Objekt instanzieren</title>
|
|
|
@@ -34,7 +34,7 @@ $client = new Zend_Http_Client('http://example.org', array(
|
|
|
'maxredirects' => 0,
|
|
|
'timeout' => 30));
|
|
|
|
|
|
-// Dies macht genau das selbe:
|
|
|
+// Dies macht genau dasselbe:
|
|
|
$client = new Zend_Http_Client();
|
|
|
$client->setUri('http://example.org');
|
|
|
$client->setConfig(array(
|
|
|
@@ -51,10 +51,10 @@ $client->setConfig($config);
|
|
|
<note>
|
|
|
<para>
|
|
|
<classname>Zend_Http_Client</classname> verwendet
|
|
|
- <classname>Zend_Uri_Http</classname> um URLs zu prüfen. Das bedeutet das einige
|
|
|
+ <classname>Zend_Uri_Http</classname> um URLs zu prüfen. Das bedeutet, dass einige
|
|
|
spezielle Zeichen wie das Pipe-Symbol ('|') oder das Karet Symbol ('^') in der
|
|
|
- URL standardmäßig nicht akzeptiert werden. Das kann geändert werden indem die
|
|
|
- 'allow_unwise' Option von <classname>Zend_Uri</classname> auf
|
|
|
+ URL standardmäßig nicht akzeptiert werden. Das kann geändert werden, indem die
|
|
|
+ Option 'allow_unwise' von <classname>Zend_Uri</classname> auf
|
|
|
'<constant>TRUE</constant>' gesetzt wird. Siehe <link
|
|
|
linkend="zend.uri.validation.allowunwise">diesen Abschnitt</link> für mehr
|
|
|
Informationen.
|
|
|
@@ -67,12 +67,12 @@ $client->setConfig($config);
|
|
|
<title>Konfigurationsparameter</title>
|
|
|
|
|
|
<para>
|
|
|
- Der Konstruktor und die setConfig() Methode akzeptieren ein assoziatives Array mit
|
|
|
- Konfigurationsparametern oder ein <classname>Zend_Config</classname> Objekt. Das Setzen
|
|
|
+ Der Konstruktor und die Methode setConfig() akzeptieren ein assoziatives Array mit
|
|
|
+ Konfigurationsparametern oder ein <classname>Zend_Config</classname>-Objekt. Das Setzen
|
|
|
dieser Parameter ist optional, da alle einen Standardwert haben.
|
|
|
|
|
|
<table id="zend.http.client.configuration.table">
|
|
|
- <title>Zend_Http_Client Konfigurationsparameter</title>
|
|
|
+ <title>Konfigurationsparameter von Zend_Http_Client</title>
|
|
|
|
|
|
<tgroup cols="4">
|
|
|
<thead>
|
|
|
@@ -97,9 +97,9 @@ $client->setConfig($config);
|
|
|
|
|
|
<entry>
|
|
|
Ob Prüfungen an Headernamen durchzuführen sind. Einige
|
|
|
- Prüf-Funktionen werden übersprungen wenn auf
|
|
|
+ Prüffunktionen werden übersprungen, wenn auf
|
|
|
<constant>FALSE</constant> gesetzt. Sollte normalerweise nicht
|
|
|
- geändert werden
|
|
|
+ geändert werden.
|
|
|
</entry>
|
|
|
|
|
|
<entry>boolean</entry>
|
|
|
@@ -154,7 +154,7 @@ $client->setConfig($config);
|
|
|
<entry>adapter</entry>
|
|
|
|
|
|
<entry>
|
|
|
- Zu verwendene Adapterklasse für die Verbindung (siehe
|
|
|
+ Zu verwendende Adapterklasse für die Verbindung (siehe
|
|
|
<link linkend="zend.http.client.adapters">diesen Abschnitt</link>)
|
|
|
</entry>
|
|
|
|
|
|
@@ -168,7 +168,7 @@ $client->setConfig($config);
|
|
|
<entry>
|
|
|
Ob keep-alive Verbindungen mit dem Server aktiviert werden sollen.
|
|
|
Nützlich und kann die Performance verbessern, wenn mehrere
|
|
|
- aufeinanderfolgend Anfragen an den selben Server ausgeführt werden.
|
|
|
+ aufeinanderfolgende Anfragen an denselben Server ausgeführt werden.
|
|
|
</entry>
|
|
|
|
|
|
<entry>boolean</entry>
|
|
|
@@ -181,7 +181,7 @@ $client->setConfig($config);
|
|
|
<entry>
|
|
|
Ob die letzte Antwort für einen späteren Aufruf von
|
|
|
<methodname>getLastResponse()</methodname> gespeichert werden soll.
|
|
|
- Wird sie auf <constant>FALSE</constant> gesetzt gibt
|
|
|
+ Wird sie auf <constant>FALSE</constant> gesetzt, gibt
|
|
|
<methodname>getLastResponse()</methodname> <constant>NULL</constant>
|
|
|
zurück.
|
|
|
</entry>
|
|
|
@@ -190,19 +190,19 @@ $client->setConfig($config);
|
|
|
<entry><constant>TRUE</constant></entry>
|
|
|
</row>
|
|
|
|
|
|
- <row>
|
|
|
- <entry>encodecookies</entry>
|
|
|
+ <row>
|
|
|
+ <entry>encodecookies</entry>
|
|
|
|
|
|
<entry>
|
|
|
- Ob der Cookie Wert über urlencode oder urldecode übergeben werden
|
|
|
+ Ob der Cookie-Wert über urlencode oder urldecode übergeben werden
|
|
|
soll oder nicht. Dessen Aktivierung verhindert die Unterstützung
|
|
|
- bei einigen Web Servern. Dessen Deaktivierung limitiert den
|
|
|
- Bereich der Werte die Cookies enthalten können.
|
|
|
- </entry>
|
|
|
+ bei einigen Web-Servern. Dessen Deaktivierung limitiert den
|
|
|
+ Bereich der Werte, die Cookies enthalten können.
|
|
|
+ </entry>
|
|
|
|
|
|
- <entry>boolean</entry>
|
|
|
- <entry><constant>TRUE</constant></entry>
|
|
|
- </row>
|
|
|
+ <entry>boolean</entry>
|
|
|
+ <entry><constant>TRUE</constant></entry>
|
|
|
+ </row>
|
|
|
</tbody>
|
|
|
</tgroup>
|
|
|
</table>
|
|
|
@@ -210,15 +210,15 @@ $client->setConfig($config);
|
|
|
</sect2>
|
|
|
|
|
|
<sect2 id="zend.http.client.basic-requests">
|
|
|
- <title>Durchführen von einfachen HTTP Anfragen</title>
|
|
|
+ <title>Durchführen von einfachen HTTP-Anfragen</title>
|
|
|
|
|
|
<para>
|
|
|
- Das Durchführen von einfachen <acronym>HTTP</acronym> Anfragen kann sehr leicht durch
|
|
|
- Verwendung der request() Methode gemacht werden und benötigt selten mehr als drei
|
|
|
+ Das Durchführen von einfachen <acronym>HTTP</acronym>-Anfragen kann sehr leicht durch
|
|
|
+ Verwendung der Methode request() gemacht werden und benötigt selten mehr als drei
|
|
|
Codezeilen:
|
|
|
|
|
|
<example id="zend.http.client.basic-requests.example-1">
|
|
|
- <title>Durchführen einer einfache GET Anfrage</title>
|
|
|
+ <title>Durchführen einer einfache GET-Anfrage</title>
|
|
|
|
|
|
<programlisting language="php"><![CDATA[
|
|
|
$client = new Zend_Http_Client('http://example.org');
|
|
|
@@ -226,11 +226,11 @@ $response = $client->request();
|
|
|
]]></programlisting>
|
|
|
</example>
|
|
|
|
|
|
- Die request() Methode akzeptiert einen optionalen Parameter - die Anfragemethode.
|
|
|
+ Die Methode request() akzeptiert einen optionalen Parameter - die Anfragemethode.
|
|
|
Diese kann <property>GET</property>, <property>POST</property>,
|
|
|
<property>PUT</property>, <property>HEAD</property>, <property>DELETE</property>,
|
|
|
<property>TRACE</property>, <property>OPTIONS</property> oder
|
|
|
- <property>CONNECT</property> sein, wie im <acronym>HTTP</acronym> Protokoll definiert.
|
|
|
+ <property>CONNECT</property> sein, wie im <acronym>HTTP</acronym>-Protokoll definiert.
|
|
|
|
|
|
<footnote>
|
|
|
<para>
|
|
|
@@ -239,7 +239,7 @@ $response = $client->request();
|
|
|
</para>
|
|
|
</footnote>.
|
|
|
|
|
|
- Zur Erleichterung sind alle als Klassenkonstanten definiert:
|
|
|
+ Der Bequemlichkeit halber sind alle als Klassenkonstanten definiert:
|
|
|
Zend_Http_Client::GET, Zend_Http_Client::POST und so weiter.
|
|
|
</para>
|
|
|
|
|
|
@@ -268,23 +268,23 @@ $response = $client->request();
|
|
|
<title>Hinzufügen von GET und POST Parametern</title>
|
|
|
|
|
|
<para>
|
|
|
- Das Hinzufügen von <constant>GET</constant> Parametern zu einer <acronym>HTTP</acronym>
|
|
|
- Anfrage ist recht einfach und kann entweder über die Angabe als Teil der URL oder durch
|
|
|
- Verwendung der setParameterGet() Methode erfolgen. Diese Methode benötigt den Namen des
|
|
|
- <constant>GET</constant> Parameter als seinen ersten Parameter und den Wert des
|
|
|
- <constant>GET</constant> Parameter als seinen zweiten Parameter. Zur Erleichterung
|
|
|
- akzeptiert die setParameterGet() Methode auch ein einzelnes assoziatives Array mit
|
|
|
- <constant>GET</constant> Parameter als Name => Wert Variablen, was beim setzen von
|
|
|
- mehreren <constant>GET</constant> Parametern komfortabler sein kann.
|
|
|
+ Das Hinzufügen von <constant>GET</constant>-Parametern zu einer <acronym>HTTP</acronym>-Anfrage
|
|
|
+ ist recht einfach und kann entweder über die Angabe als Teil der URL oder durch
|
|
|
+ Verwendung der Methode setParameterGet() erfolgen. Diese Methode benötigt den Namen des
|
|
|
+ <constant>GET</constant>-Parameters als seinen ersten Parameter und den Wert des
|
|
|
+ <constant>GET</constant>-Parameters als seinen zweiten Parameter. Zur Erleichterung
|
|
|
+ akzeptiert die Methode setParameterGet() auch ein einzelnes assoziatives Array mit
|
|
|
+ <constant>GET</constant>-Parameter als Name => Wert Variablen, was beim Setzen von
|
|
|
+ mehreren <constant>GET</constant>-Parametern komfortabler sein kann.
|
|
|
|
|
|
<example id="zend.http.client.parameters.example-1">
|
|
|
- <title>Setzen von GET Parametern</title>
|
|
|
+ <title>Setzen von GET-Parametern</title>
|
|
|
|
|
|
<programlisting language="php"><![CDATA[
|
|
|
-// Setzen eines GET Parameter mit der setParameterGet Methode
|
|
|
+// Setzen eines GET-Parameters mit der Methode setParameterGet
|
|
|
$client->setParameterGet('knight', 'lancelot');
|
|
|
|
|
|
-// Dies ist äquivalent durch Setzen der URL:
|
|
|
+// Dies ist äquivalent zum Setzen der URL:
|
|
|
$client->setUri('http://example.com/index.php?knight=lancelot');
|
|
|
|
|
|
// Hinzufügen mehrerer Parameter durch einen Aufruf
|
|
|
@@ -298,20 +298,20 @@ $client->setParameterGet(array(
|
|
|
</para>
|
|
|
|
|
|
<para>
|
|
|
- Während <constant>GET</constant> Parameter bei jeder Anfragemethode gesetzt werden
|
|
|
- können, können POST Parameter nur im Hauptteil von POST Anfragen versendet werden. Das
|
|
|
- Hinzufügen von POST Parameter zu einer Anfrage ist sehr ähnlich wie das Hinzufügen von
|
|
|
- <constant>GET</constant> Parametern and kann mit der setParameterPost() Methode gemacht
|
|
|
- werden, die vom Aufbau der setParameterGet() Methode ähnlich ist..
|
|
|
+ Während <constant>GET</constant>-Parameter bei jeder Anfragemethode gesetzt werden
|
|
|
+ können, können POST-Parameter nur im Hauptteil von POST-Anfragen versendet werden. Das
|
|
|
+ Hinzufügen von POST-Parameter zu einer Anfrage ist sehr ähnlich wie das Hinzufügen von
|
|
|
+ <constant>GET</constant>-Parametern and kann mit der Methode setParameterPost() gemacht
|
|
|
+ werden, die vom Aufbau der Methode setParameterGet() ähnlich ist.
|
|
|
|
|
|
<example id="zend.http.client.parameters.example-2">
|
|
|
- <title>Setzen von POST Parametern</title>
|
|
|
+ <title>Setzen von POST-Parametern</title>
|
|
|
|
|
|
<programlisting language="php"><![CDATA[
|
|
|
-// Setzen eines POST Parameters
|
|
|
+// Setzen eines POST-Parameters
|
|
|
$client->setParameterPost('language', 'fr');
|
|
|
|
|
|
-// Hinzufügen von mehreren POST Parametern, eines davon mit mehreren Werten
|
|
|
+// Hinzufügen von mehreren POST-Parametern, eines davon mit mehreren Werten
|
|
|
$client->setParameterPost(array(
|
|
|
'language' => 'es',
|
|
|
'country' => 'ar',
|
|
|
@@ -320,25 +320,25 @@ $client->setParameterPost(array(
|
|
|
]]></programlisting>
|
|
|
</example>
|
|
|
|
|
|
- Beim Senden einer POST Anfrage ist zu beachten, dass man sowohl <constant>GET</constant>
|
|
|
- als auch POST Parameter setzen kann. Auf der anderen Seite wird durch das Setzen von
|
|
|
- POST Parametern für andere Anfragen als POST kein Fehler ausgeworfen. Solange eine
|
|
|
- Anfrage keine POST Anfrage ist, werden POST Parameter einfach ignoriert.
|
|
|
+ Beim Senden einer POST-Anfrage ist zu beachten, dass man sowohl <constant>GET</constant>-
|
|
|
+ als auch POST-Parameter setzen kann. Auf der anderen Seite wird durch das Setzen von
|
|
|
+ POST-Parametern für andere Anfragen als POST kein Fehler ausgeworfen. Solange eine
|
|
|
+ Anfrage keine POST-Anfrage ist, werden POST-Parameter einfach ignoriert.
|
|
|
</para>
|
|
|
</sect2>
|
|
|
|
|
|
<sect2 id="zend.http.client.accessing_last">
|
|
|
- <title>Zugriff auf die Letzte Anfrage und Antwort</title>
|
|
|
+ <title>Zugriff auf die letzte Anfrage und Antwort</title>
|
|
|
|
|
|
<para>
|
|
|
- <classname>Zend_Http_Client</classname> bietet Methoden um Zugriff auf die letzte
|
|
|
- gesendete Anfrage und die letzte empfangene Antwort des Client Objekts zu bekommen.
|
|
|
+ <classname>Zend_Http_Client</classname> verfügt über Methoden für den Zugriff auf die
|
|
|
+ letzte gesendete Anfrage und die letzte empfangene Antwort des Client-Objekts.
|
|
|
<classname>Zend_Http_Client->getLastRequest()</classname> hat keine Parameter und gibt
|
|
|
- die letzte <acronym>HTTP</acronym> Anfrage als String zurück die der Client gesendet
|
|
|
+ die letzte <acronym>HTTP</acronym>-Anfrage als String zurück, die der Client gesendet
|
|
|
hat. Auf die gleiche Art und Weise gibt
|
|
|
<classname>Zend_Http_Client->getLastResponse()</classname> die letzte
|
|
|
- <acronym>HTTP</acronym> Antwort als <link
|
|
|
- linkend="zend.http.response">Zend_Http_Response</link> Objekt zurück die der Client
|
|
|
+ <acronym>HTTP</acronym>-Antwort als <link
|
|
|
+ linkend="zend.http.response">Zend_Http_Response</link> Objekt zurück, die der Client
|
|
|
empfangen hat.
|
|
|
</para>
|
|
|
</sect2>
|