|
|
@@ -1,6 +1,6 @@
|
|
|
<?xml version="1.0" encoding="UTF-8"?>
|
|
|
<!-- EN-Revision: 22747 -->
|
|
|
-<!-- Reviewed: no -->
|
|
|
+<!-- Reviewed: 22747 -->
|
|
|
<sect1 id="zend.http.response">
|
|
|
<title>Zend_Http_Response</title>
|
|
|
|
|
|
@@ -9,20 +9,20 @@
|
|
|
|
|
|
<para>
|
|
|
<classname>Zend_Http_Response</classname> stellt den einfachen Zugriff auf eine
|
|
|
- <acronym>HTTP</acronym> Rückantwort sowie einige statische Methoden zum Analysieren der
|
|
|
- <acronym>HTTP</acronym> Rückantworten bereit. Normalerweise wird
|
|
|
- <classname>Zend_Http_Response</classname> als ein Objekt verwendet, dass von einer
|
|
|
- <classname>Zend_Http_Client</classname> Anfrage zurückgegeben wurde.
|
|
|
+ <acronym>HTTP</acronym>-Rückantwort sowie einige statische Methoden zur Analyse der
|
|
|
+ <acronym>HTTP</acronym>-Rückantworten bereit. Normalerweise wird
|
|
|
+ <classname>Zend_Http_Response</classname> als ein Objekt verwendet, das von einer
|
|
|
+ <classname>Zend_Http_Client</classname>-Anfrage zurückgegeben wurde.
|
|
|
</para>
|
|
|
|
|
|
<para>
|
|
|
- In den meisten Fällen wird ein <classname>Zend_Http_Response</classname> Objekt über die
|
|
|
- fromString() Methode instanziert, die einen String liest, der eine
|
|
|
- <acronym>HTTP</acronym> Rückantwort enthält und ein
|
|
|
- <classname>Zend_Http_Response</classname> Objekt zurückgibt.
|
|
|
+ In den meisten Fällen wird ein <classname>Zend_Http_Response</classname>-Objekt über die
|
|
|
+ Methode fromString() instanziert, die einen String liest, der eine
|
|
|
+ <acronym>HTTP</acronym>-Rückantwort enthält und ein
|
|
|
+ <classname>Zend_Http_Response</classname>-Objekt zurückgibt.
|
|
|
|
|
|
<example id="zend.http.response.introduction.example-1">
|
|
|
- <title>Ein Zend_Http_Response Object über die factory Methode instanzieren</title>
|
|
|
+ <title>Ein Zend_Http_Response-Objekt über die Factory-Methode instanzieren</title>
|
|
|
|
|
|
<programlisting language="php"><![CDATA[
|
|
|
$str = '';
|
|
|
@@ -42,8 +42,8 @@ $response = Zend_Http_Response::fromString($str);
|
|
|
</para>
|
|
|
|
|
|
<para>
|
|
|
- Man kann auch die Konstruktormethode verwenden, um ein neues Response Objekt zu
|
|
|
- erstellen, indem man alle Parameter für die Antwort angibt:
|
|
|
+ Man kann auch die Konstruktormethode verwenden, um ein neues Zend_Http_Response-Objekt
|
|
|
+ zu erstellen, indem man alle Parameter für die Antwort angibt:
|
|
|
</para>
|
|
|
|
|
|
<para>
|
|
|
@@ -54,7 +54,7 @@ $response = Zend_Http_Response::fromString($str);
|
|
|
<itemizedlist>
|
|
|
<listitem>
|
|
|
<para>
|
|
|
- <varname>$code</varname>: Der <acronym>HTTP</acronym> Antwortcode(eg. 200, 404,
|
|
|
+ <varname>$code</varname>: Der <acronym>HTTP</acronym>-Antwortcode(eg. 200, 404,
|
|
|
etc.)
|
|
|
</para>
|
|
|
</listitem>
|
|
|
@@ -74,14 +74,14 @@ $response = Zend_Http_Response::fromString($str);
|
|
|
|
|
|
<listitem>
|
|
|
<para>
|
|
|
- <varname>$version</varname>: Der Version der <acronym>HTTP</acronym> Antwort
|
|
|
+ <varname>$version</varname>: Der Version der <acronym>HTTP</acronym>-Antwort
|
|
|
(normalerweise 1.0 oder 1.1)
|
|
|
</para>
|
|
|
</listitem>
|
|
|
|
|
|
<listitem>
|
|
|
<para>
|
|
|
- <varname>$message</varname>: Die <acronym>HTTP</acronym> Rückantwort (z.B. 'OK',
|
|
|
+ <varname>$message</varname>: Die <acronym>HTTP</acronym>-Rückantwort (z.B. 'OK',
|
|
|
'Internal Server Error'). Falls nicht angegeben, wird die Rückantwort anhand des
|
|
|
Antwortcode gesetzt.
|
|
|
</para>
|
|
|
@@ -93,7 +93,7 @@ $response = Zend_Http_Response::fromString($str);
|
|
|
<title>Boolesche Testmethoden</title>
|
|
|
|
|
|
<para>
|
|
|
- Sobald ein <classname>Zend_Http_Response</classname> Objekt instantiert ist, stellt es
|
|
|
+ Sobald ein <classname>Zend_Http_Response</classname>-Objekt instanziert ist, stellt es
|
|
|
mehrere Methoden bereit, die zum Testen des Typs der Antwort verwendet werden können.
|
|
|
Diese geben alle ein boolesches <constant>TRUE</constant> oder
|
|
|
<constant>FALSE</constant> zurück:
|
|
|
@@ -101,7 +101,7 @@ $response = Zend_Http_Response::fromString($str);
|
|
|
<itemizedlist>
|
|
|
<listitem>
|
|
|
<para>
|
|
|
- <methodname>isSuccessful()</methodname>: Ob die Anfrage erfolgreoch war oder
|
|
|
+ <methodname>isSuccessful()</methodname>: Ob die Anfrage erfolgreich war oder
|
|
|
nicht. Gibt <constant>TRUE</constant> für <acronym>HTTP</acronym> 1xx und
|
|
|
2xx Antwortcodes zurück.
|
|
|
</para>
|
|
|
@@ -126,7 +126,7 @@ $response = Zend_Http_Response::fromString($str);
|
|
|
</itemizedlist>
|
|
|
|
|
|
<example id="zend.http.response.testers.example-1">
|
|
|
- <title>Die isError() Method verwenden, um eine Antwort zu validieren</title>
|
|
|
+ <title>Die Methode isError() verwenden, um eine Antwort zu validieren</title>
|
|
|
|
|
|
<programlisting language="php"><![CDATA[
|
|
|
if ($response->isError()) {
|
|
|
@@ -144,14 +144,14 @@ if ($response->isError()) {
|
|
|
<title>Zugriffsmethoden</title>
|
|
|
|
|
|
<para>
|
|
|
- Der Hauptzweck eines Response Okjektes ist der einfache Zugriff auf diverse
|
|
|
+ Der Hauptzweck eines Zend_Http_Response-Objekts ist der einfache Zugriff auf diverse
|
|
|
Antwortparameter.
|
|
|
|
|
|
<itemizedlist>
|
|
|
<listitem>
|
|
|
<para>
|
|
|
<methodname>getStatus()</methodname>: Erhalte den <acronym>HTTP</acronym>
|
|
|
- Antwortstatuscode (z.B. 200, 504, etc.) zurück
|
|
|
+ Antwortstatuscode (z.B. 200, 504, etc.) zurück.
|
|
|
</para>
|
|
|
</listitem>
|
|
|
|
|
|
@@ -165,30 +165,30 @@ if ($response->isError()) {
|
|
|
<listitem>
|
|
|
<para>
|
|
|
<methodname>getBody()</methodname>: Erhalte den kompletten dekodierten
|
|
|
- Hauptteil der <acronym>HTTP</acronym> Antwort zurück
|
|
|
+ Hauptteil der <acronym>HTTP</acronym>-Antwort zurück.
|
|
|
</para>
|
|
|
</listitem>
|
|
|
|
|
|
<listitem>
|
|
|
<para>
|
|
|
- <methodname>getRawBody()</methodname>: Erhalte die rohen, möglicherweise
|
|
|
- kodierten Hauptteil der <acronym>HTTP</acronym> Antwort zurück. Wenn der
|
|
|
+ <methodname>getRawBody()</methodname>: Erhalte den rohen, möglicherweise
|
|
|
+ kodierten Hauptteil der <acronym>HTTP</acronym>-Antwort zurück. Wenn der
|
|
|
Hauptteil z.B. mittels GZIP kodiert wurde, wird er nicht dekodiert.
|
|
|
</para>
|
|
|
</listitem>
|
|
|
|
|
|
<listitem>
|
|
|
<para>
|
|
|
- <methodname>getHeaders()</methodname>: Erhalte die <acronym>HTTP</acronym>
|
|
|
- Antwort Header als assoziatives Array (z.B. 'Content-type' => 'text/html')
|
|
|
- zurück.
|
|
|
+ <methodname>getHeaders()</methodname>: Erhalte die
|
|
|
+ <acronym>HTTP</acronym>-Antwort-Header als assoziatives Array
|
|
|
+ (z.B. 'Content-type' => 'text/html') zurück.
|
|
|
</para>
|
|
|
</listitem>
|
|
|
|
|
|
<listitem>
|
|
|
<para>
|
|
|
<methodname>getHeader($header)</methodname>: Erhalte einen spezifischen
|
|
|
- <acronym>HTTP</acronym> Antwort Header zurück, der durch $header angegeben
|
|
|
+ <acronym>HTTP</acronym>-Antwort-Header zurück, der durch $header angegeben
|
|
|
wird.
|
|
|
</para>
|
|
|
</listitem>
|
|
|
@@ -196,10 +196,10 @@ if ($response->isError()) {
|
|
|
<listitem>
|
|
|
<para>
|
|
|
<methodname>getHeadersAsString($status_line, $br)</methodname>:
|
|
|
- Erhalte den kompletten Header Satz als String zurück. Wenn
|
|
|
+ Erhalte den kompletten Header-Satz als String zurück. Wenn
|
|
|
<varname>$status_line</varname> auf <constant>TRUE</constant> gesetzt ist
|
|
|
(Standardwert), wird die erste Statuszeile (z.B. "HTTP/1.1 200 OK")
|
|
|
- ebenfalls zurück gegeben. Die Zeilen werden durch den <varname>$br</varname>
|
|
|
+ ebenfalls zurückgegeben. Die Zeilen werden durch den <varname>$br</varname>
|
|
|
Parameter umgebrochen (kann z.B. "<br />" sein. Standardwert ist
|
|
|
"\n").
|
|
|
</para>
|
|
|
@@ -208,11 +208,11 @@ if ($response->isError()) {
|
|
|
<listitem>
|
|
|
<para>
|
|
|
<methodname>asString($br)</methodname>: Erhalte die komplette Rückantwort
|
|
|
- als String zurück. Die Zeilen werden durch den $br Parameter umgebrochen
|
|
|
+ als String zurück. Die Zeilen werden durch den Parameter $br umgebrochen
|
|
|
(kann z.B. "<br />" sein. Standardwert ist "\n"). Man kann auch die
|
|
|
- magische <methodname>__toString()</methodname> Methode verwenden wenn man
|
|
|
+ magische Methode <methodname>__toString()</methodname> verwenden, wenn man
|
|
|
das Objekt in einen String casten will. Diese wird dann auf
|
|
|
- <methodname>asString()</methodname> weiterleiten
|
|
|
+ <methodname>asString()</methodname> weiterleiten.
|
|
|
</para>
|
|
|
</listitem>
|
|
|
</itemizedlist>
|
|
|
@@ -235,15 +235,15 @@ if ($response->getStatus() == 200) {
|
|
|
<title>Immer die Rückgabewerte prüfen</title>
|
|
|
|
|
|
<para>
|
|
|
- Weil eine Antwort mehrere Instanzen des selben Headers beinhalten kann, können
|
|
|
- die getHeader() Methode und getHeaders() Methode entweder einen einzelnen String
|
|
|
+ Weil eine Antwort mehrere Instanzen desselben Headers beinhalten kann, können
|
|
|
+ die Methoden getHeader() und getHeaders() entweder einen einzelnen String
|
|
|
oder ein Array mit Strings für jeden Header zurückgeben. Man sollte immer
|
|
|
prüfen, ob der Rückgabewert ein String oder ein Array ist.
|
|
|
</para>
|
|
|
</note>
|
|
|
|
|
|
<example id="zend.http.response.acessors.example-2">
|
|
|
- <title>Auf Antwort Header zugreifen</title>
|
|
|
+ <title>Auf Antwort-Header zugreifen</title>
|
|
|
|
|
|
<programlisting language="php"><![CDATA[
|
|
|
$ctype = $response->getHeader('Content-type');
|
|
|
@@ -261,20 +261,21 @@ echo $body;
|
|
|
</sect2>
|
|
|
|
|
|
<sect2 id="zend.http.response.static_parsers">
|
|
|
- <title>Statische HTTP Antwortanalysierer</title>
|
|
|
+ <title>Statische HTTP-Antwortanalysierer</title>
|
|
|
|
|
|
<para>
|
|
|
- Die <classname>Zend_Http_Response</classname> Klasse beinhaltet auch verschiedene,
|
|
|
- intern verwendete Methoden für die Verarbeitung und Analyse der <acronym>HTTP</acronym>
|
|
|
- Rückantworten bereit. Diese Methoden sind alle als statische Methoden eingerichtet, so
|
|
|
- dass man sie extern verwenden kann, ohne dass man ein Response Objekt instanzierebn muss
|
|
|
- und nur einen bestimmten Teil der Antwort extrahieren möchte.
|
|
|
+ Die Klasse <classname>Zend_Http_Response</classname> beinhaltet auch verschiedene,
|
|
|
+ intern verwendete Methoden für die Verarbeitung und Analyse der
|
|
|
+ <acronym>HTTP</acronym>-Rückantworten. Diese Methoden sind alle als statische Methoden
|
|
|
+ eingerichtet, so dass man sie extern verwenden kann, ohne dass man ein
|
|
|
+ Zend_Http_Response-Objekt instanzieren muss und nur einen bestimmten Teil der Antwort
|
|
|
+ extrahieren möchte.
|
|
|
|
|
|
<itemizedlist>
|
|
|
<listitem>
|
|
|
<para>
|
|
|
<methodname>Zend_Http_Response::extractCode($response_str)</methodname>:
|
|
|
- Extrahiere den <acronym>HTTP</acronym> Antwortcode (z.B. 200 oder 404) von
|
|
|
+ Extrahiere den <acronym>HTTP</acronym>-Antwortcode (z.B. 200 oder 404) von
|
|
|
<varname>$response_str</varname> und gebe ihn zurück.
|
|
|
</para>
|
|
|
</listitem>
|
|
|
@@ -282,7 +283,7 @@ echo $body;
|
|
|
<listitem>
|
|
|
<para>
|
|
|
<methodname>Zend_Http_Response::extractMessage($response_str)</methodname>:
|
|
|
- Extrahiere die <acronym>HTTP</acronym> Rückantwort (z.B. "OK" oder
|
|
|
+ Extrahiere die <acronym>HTTP</acronym>-Rückantwort (z.B. "OK" oder
|
|
|
"File Not Found") von <varname>$response_str</varname> und gebe sie zurück.
|
|
|
</para>
|
|
|
</listitem>
|
|
|
@@ -290,7 +291,7 @@ echo $body;
|
|
|
<listitem>
|
|
|
<para>
|
|
|
<methodname>Zend_Http_Response::extractVersion($response_str)</methodname>:
|
|
|
- Extrahiere die <acronym>HTTP</acronym> Version (z.B. 1.1 oder 1.0) von
|
|
|
+ Extrahiere die <acronym>HTTP</acronym>-Version (z.B. 1.1 oder 1.0) von
|
|
|
<varname>$response_str</varname> und gebe sie zurück.
|
|
|
</para>
|
|
|
</listitem>
|
|
|
@@ -298,7 +299,7 @@ echo $body;
|
|
|
<listitem>
|
|
|
<para>
|
|
|
<methodname>Zend_Http_Response::extractHeaders($response_str)</methodname>:
|
|
|
- Extrahiere die <acronym>HTTP</acronym> Antwort Header von
|
|
|
+ Extrahiere die <acronym>HTTP</acronym>-Antwort-Header von
|
|
|
<varname>$response_str</varname> und gebe sie in einem Array zurück.
|
|
|
</para>
|
|
|
</listitem>
|
|
|
@@ -306,7 +307,7 @@ echo $body;
|
|
|
<listitem>
|
|
|
<para>
|
|
|
<methodname>Zend_Http_Response::extractBody($response_str)</methodname>:
|
|
|
- Extrahiere den <acronym>HTTP</acronym> Antworthauptteil aus
|
|
|
+ Extrahiere den <acronym>HTTP</acronym>-Antworthauptteil aus
|
|
|
<varname>$response_str</varname> und gebe ihn zurück.
|
|
|
</para>
|
|
|
</listitem>
|
|
|
@@ -318,10 +319,10 @@ echo $body;
|
|
|
Rückantwort für einen Antwortcode $code. Zum Beispiel wird "Internal Server
|
|
|
Error" zurückgegeben, wenn <varname>$code</varname> gleich 500 ist. Wenn
|
|
|
<varname>$http11</varname> gleich <constant>TRUE</constant> ist (Standard),
|
|
|
- werden die <acronym>HTTP</acronym>/1.1 Standardantworten zurück gegeben,
|
|
|
+ werden die <acronym>HTTP</acronym>/1.1 Standardantworten zurückgegeben,
|
|
|
andernfalls die <acronym>HTTP</acronym>/1.0 Antworten. Wird
|
|
|
<varname>$code</varname> nicht angegeben, wird diese Methode alle bekannten
|
|
|
- <acronym>HTTP</acronym> Antwortcodes als assoziatives Array (code =>
|
|
|
+ <acronym>HTTP</acronym>-Antwortcodes als assoziatives Array (code =>
|
|
|
message) zurückgeben.
|
|
|
</para>
|
|
|
</listitem>
|
|
|
@@ -329,8 +330,8 @@ echo $body;
|
|
|
</para>
|
|
|
|
|
|
<para>
|
|
|
- Neben der Analysemethoden beinhaltet die Klasse auch einen Satz von Dekodieren für
|
|
|
- allgemein <acronym>HTTP</acronym> Antwort Transferkodierungen:
|
|
|
+ Neben der Analysemethoden beinhaltet die Klasse auch einen Satz von Dekodierern für
|
|
|
+ allgemeine <acronym>HTTP</acronym>-Antwort-Transferkodierungen:
|
|
|
|
|
|
<itemizedlist>
|
|
|
<listitem>
|