|
@@ -1,6 +1,6 @@
|
|
|
<?xml version="1.0" encoding="UTF-8"?>
|
|
<?xml version="1.0" encoding="UTF-8"?>
|
|
|
<!-- Reviewed: no -->
|
|
<!-- Reviewed: no -->
|
|
|
-<!-- EN-Revision: 22646 -->
|
|
|
|
|
|
|
+<!-- EN-Revision: 22743 -->
|
|
|
<sect1 id="zend.http.client">
|
|
<sect1 id="zend.http.client">
|
|
|
<title>導入</title>
|
|
<title>導入</title>
|
|
|
|
|
|
|
@@ -11,7 +11,7 @@
|
|
|
<acronym>HTTP</acronym> 認証やファイルのアップロードといった高度な機能もサポートしています。
|
|
<acronym>HTTP</acronym> 認証やファイルのアップロードといった高度な機能もサポートしています。
|
|
|
リクエストに成功すると (失敗しても) <classname>Zend_Http_Response</classname>
|
|
リクエストに成功すると (失敗しても) <classname>Zend_Http_Response</classname>
|
|
|
オブジェクトを返します。これを使用すると、レスポンスのヘッダや本文にアクセスできます
|
|
オブジェクトを返します。これを使用すると、レスポンスのヘッダや本文にアクセスできます
|
|
|
- (<xref linkend="zend.http.response" /> を参照ください)。
|
|
|
|
|
|
|
+ (<link linkend="zend.http.response">このセクション</link>を参照して下さい)。
|
|
|
</para>
|
|
</para>
|
|
|
|
|
|
|
|
<sect2 id="zend.http.client.usage">
|
|
<sect2 id="zend.http.client.usage">
|
|
@@ -51,8 +51,8 @@ $client->setConfig($config);
|
|
|
つまり、URL 中にあるパイプ記号 ('|') やキャレット記号 ('^')
|
|
つまり、URL 中にあるパイプ記号 ('|') やキャレット記号 ('^')
|
|
|
などの特殊文字はデフォルトでは許可されないということです。
|
|
などの特殊文字はデフォルトでは許可されないということです。
|
|
|
これを変更するには、<classname>Zend_Uri</classname> のオプション 'allow_unwise' を
|
|
これを変更するには、<classname>Zend_Uri</classname> のオプション 'allow_unwise' を
|
|
|
- '<constant>TRUE</constant>' に設定します。詳細は <xref
|
|
|
|
|
- linkend="zend.uri.validation.allowunwise" />
|
|
|
|
|
|
|
+ '<constant>TRUE</constant>' に設定します。詳細は <link
|
|
|
|
|
+ linkend="zend.uri.validation.allowunwise">このセクション</link>
|
|
|
を参照ください。
|
|
を参照ください。
|
|
|
</para>
|
|
</para>
|
|
|
</note>
|
|
</note>
|
|
@@ -103,8 +103,8 @@ $client->setConfig($config);
|
|
|
<row>
|
|
<row>
|
|
|
<entry>strictredirects</entry>
|
|
<entry>strictredirects</entry>
|
|
|
<entry>
|
|
<entry>
|
|
|
- リダイレクトの際に RFC に厳密に従うかどうか (<xref
|
|
|
|
|
- linkend="zend.http.client.redirections" /> を参照ください)
|
|
|
|
|
|
|
+ リダイレクトの際に RFC に厳密に従うかどうか (<link
|
|
|
|
|
+ linkend="zend.http.client.redirections">このセクション</link>を参照ください)
|
|
|
</entry>
|
|
</entry>
|
|
|
<entry>boolean</entry>
|
|
<entry>boolean</entry>
|
|
|
<entry><constant>FALSE</constant></entry>
|
|
<entry><constant>FALSE</constant></entry>
|
|
@@ -134,8 +134,8 @@ $client->setConfig($config);
|
|
|
<row>
|
|
<row>
|
|
|
<entry>adapter</entry>
|
|
<entry>adapter</entry>
|
|
|
<entry>
|
|
<entry>
|
|
|
- 使用する接続アダプタクラス (<xref
|
|
|
|
|
- linkend="zend.http.client.adapters" /> を参照ください)
|
|
|
|
|
|
|
+ 使用する接続アダプタクラス (<link
|
|
|
|
|
+ linkend="zend.http.client.adapters">このセクション</link>を参照ください)
|
|
|
</entry>
|
|
</entry>
|
|
|
<entry>mixed</entry>
|
|
<entry>mixed</entry>
|
|
|
<entry>'Zend_Http_Client_Adapter_Socket'</entry>
|
|
<entry>'Zend_Http_Client_Adapter_Socket'</entry>
|
|
@@ -164,6 +164,7 @@ $client->setConfig($config);
|
|
|
<entry><constant>TRUE</constant></entry>
|
|
<entry><constant>TRUE</constant></entry>
|
|
|
</row>
|
|
</row>
|
|
|
|
|
|
|
|
|
|
+ <!-- TODO : to be translated -->
|
|
|
<row>
|
|
<row>
|
|
|
<entry>encodecookies</entry>
|
|
<entry>encodecookies</entry>
|
|
|
<entry>Whether to pass the cookie value through urlencode/urldecode.
|
|
<entry>Whether to pass the cookie value through urlencode/urldecode.
|
|
@@ -196,7 +197,9 @@ $response = $client->request();
|
|
|
|
|
|
|
|
request() メソッドには、オプションでパラメータを指定できます。
|
|
request() メソッドには、オプションでパラメータを指定できます。
|
|
|
このパラメータはリクエストメソッドで、<acronym>HTTP</acronym> プロトコルで定義されている
|
|
このパラメータはリクエストメソッドで、<acronym>HTTP</acronym> プロトコルで定義されている
|
|
|
- GET、POST、PUT、HEAD、DELETE、TRACE、OPTIONS そして CONNECT
|
|
|
|
|
|
|
+ <property>GET</property>、<property>POST</property>、<property>PUT</property>、
|
|
|
|
|
+ <property>HEAD</property>、<property>DELETE</property>、<property>TRACE</property>、
|
|
|
|
|
+ <property>OPTIONS</property> そして <property>CONNECT</property>
|
|
|
のいずれかを指定可能です。
|
|
のいずれかを指定可能です。
|
|
|
|
|
|
|
|
<footnote>
|
|
<footnote>
|
|
@@ -210,9 +213,9 @@ $response = $client->request();
|
|
|
</para>
|
|
</para>
|
|
|
|
|
|
|
|
<para>
|
|
<para>
|
|
|
- メソッドを指定しない場合は、直近の setMethod() コールで指定されたメソッドを使用します。
|
|
|
|
|
- setMethod() もコールされていない場合は、デフォルトのリクエストメソッドとして
|
|
|
|
|
- GET を使用します (上の例を参照ください)。
|
|
|
|
|
|
|
+ メソッドを指定しない場合は、直近の <methodname>setMethod()</methodname> コールで指定されたメソッドを使用します。
|
|
|
|
|
+ <methodname>setMethod()</methodname> もコールされていない場合は、デフォルトのリクエストメソッドとして
|
|
|
|
|
+ <property>GET</property> を使用します (上の例を参照ください)。
|
|
|
|
|
|
|
|
<example id="zend.http.client.basic-requests.example-2">
|
|
<example id="zend.http.client.basic-requests.example-2">
|
|
|
<title>GET 以外のリクエストメソッドの使用</title>
|
|
<title>GET 以外のリクエストメソッドの使用</title>
|
|
@@ -233,13 +236,13 @@ $response = $client->request();
|
|
|
<title>GET や POST へのパラメータの追加</title>
|
|
<title>GET や POST へのパラメータの追加</title>
|
|
|
|
|
|
|
|
<para>
|
|
<para>
|
|
|
- GET パラメータを <acronym>HTTP</acronym> リクエストに追加するのは簡単です。
|
|
|
|
|
|
|
+ <property>GET</property> パラメータを <acronym>HTTP</acronym> リクエストに追加するのは簡単です。
|
|
|
URL の一部として指定するか、あるいは setParameterGet() メソッドを使用します。
|
|
URL の一部として指定するか、あるいは setParameterGet() メソッドを使用します。
|
|
|
- このメソッドは、GET パラメータの名前を最初の引数、そして
|
|
|
|
|
- GET パラメータの値を二番目の引数として受け取ります。
|
|
|
|
|
|
|
+ このメソッドは、<property>GET</property> パラメータの名前を最初の引数、そして
|
|
|
|
|
+ <property>GET</property> パラメータの値を二番目の引数として受け取ります。
|
|
|
さらに便利に使用するため、setParameterGet()
|
|
さらに便利に使用するため、setParameterGet()
|
|
|
- メソッドでは name => value 形式の連想配列で GET 変数を指定することもできます。
|
|
|
|
|
- これは、複数の GET パラメータを指定する必要がある場合に便利です。
|
|
|
|
|
|
|
+ メソッドでは name => value 形式の連想配列で <property>GET</property> 変数を指定することもできます。
|
|
|
|
|
+ これは、複数の <property>GET</property> パラメータを指定する必要がある場合に便利です。
|
|
|
|
|
|
|
|
<example id="zend.http.client.parameters.example-1">
|
|
<example id="zend.http.client.parameters.example-1">
|
|
|
<title>GET パラメータの設定</title>
|
|
<title>GET パラメータの設定</title>
|
|
@@ -262,9 +265,9 @@ $client->setParameterGet(array(
|
|
|
</para>
|
|
</para>
|
|
|
|
|
|
|
|
<para>
|
|
<para>
|
|
|
- GET パラメータはあらゆるリクエストメソッドで送信できますが、
|
|
|
|
|
|
|
+ <property>GET</property> パラメータはあらゆるリクエストメソッドで送信できますが、
|
|
|
POST パラメータは POST リクエストの本文としてしか送信できません。
|
|
POST パラメータは POST リクエストの本文としてしか送信できません。
|
|
|
- POST パラメータをリクエストに追加する方法は、GET
|
|
|
|
|
|
|
+ POST パラメータをリクエストに追加する方法は、<property>GET</property>
|
|
|
パラメータを追加する場合と非常に似ています。
|
|
パラメータを追加する場合と非常に似ています。
|
|
|
使用するのは setParameterPost() メソッドで、このメソッドの使用法は
|
|
使用するのは setParameterPost() メソッドで、このメソッドの使用法は
|
|
|
setParameterGet() メソッドと同じです。
|
|
setParameterGet() メソッドと同じです。
|
|
@@ -285,7 +288,7 @@ $client->setParameterPost(array(
|
|
|
]]></programlisting>
|
|
]]></programlisting>
|
|
|
</example>
|
|
</example>
|
|
|
|
|
|
|
|
- POST リクエストを送信する際には、GET パラメータと POST
|
|
|
|
|
|
|
+ POST リクエストを送信する際には、<property>GET</property> パラメータと POST
|
|
|
パラメータの両方を設定できることに注意しましょう。
|
|
パラメータの両方を設定できることに注意しましょう。
|
|
|
一方、POST パラメータを POST 以外のリクエストで指定しても何のエラーも発生しませんが、
|
|
一方、POST パラメータを POST 以外のリクエストで指定しても何のエラーも発生しませんが、
|
|
|
これは無意味です。POST 以外のリクエストでは、
|
|
これは無意味です。POST 以外のリクエストでは、
|