[DOCUMENTATION]Japanese sync

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

documentation/manual/ja/module_specs/Zend_Filter-FilterChains.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!-- Reviewed: no -->
-<!-- EN-Revision: 20774 -->
+<!-- EN-Revision: 21123 -->
 <sect1 id="zend.filter.filter_chains">
 
     <title>フィルタチェイン</title>
@@ -11,8 +11,9 @@
         小文字の英字のみに限定する場合などです。
         <classname>Zend_Filter</classname> は、複数のフィルタを連結する機能を提供しています。
         以下のコードで、二つのフィルタをユーザ名に対して適用する方法を説明します。
+    </para>
 
-        <programlisting language="php"><![CDATA[
+    <programlisting language="php"><![CDATA[
 // フィルタチェインを作成し、そこにフィルタを追加します
 $filterChain = new Zend_Filter();
 $filterChain->addFilter(new Zend_Filter_Alpha())
@@ -22,10 +23,10 @@ $filterChain->addFilter(new Zend_Filter_Alpha())
 $username = $filterChain->filter($_POST['username']);
 ]]></programlisting>
 
+    <para>
         フィルタは、<classname>Zend_Filter</classname> に追加した順に適用されます。
         上の例では、まずユーザ名から非英字を除去したあとで、
         大文字を小文字に変換します。
-
     </para>
 
     <para>

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

@@ -1,11 +1,12 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!-- Reviewed: no -->
-<!-- EN-Revision: 20115 -->
+<!-- EN-Revision: 21145 -->
 <sect1 id="zend.http.client.adapters">
     <title>Zend_Http_Client - 接続アダプタ</title>
 
     <sect2 id="zend.http.client.adapters.overview">
         <title>概要</title>
+
         <para>
             <classname>Zend_Http_Client</classname> は、接続アダプタとして設計されています。
             接続アダプタは実際にサーバへの接続を行うオブジェクトで、
@@ -15,6 +16,7 @@
             <acronym>HTTP</acronym> クライアントクラス全体を書き換える必要はありません。
             同じインターフェイスを実装しているだけでいいのです。
         </para>
+
         <para>
             現在、<classname>Zend_Http_Client</classname> クラスは四つの組み込み接続アダプタを提供しています。
             <itemizedlist>
@@ -23,16 +25,19 @@
                         <classname>Zend_Http_Client_Adapter_Socket</classname> (デフォルト)
                     </para>
                 </listitem>
+
                 <listitem>
                     <para>
                         <classname>Zend_Http_Client_Adapter_Proxy</classname>
                     </para>
                 </listitem>
+
                 <listitem>
                     <para>
                         <classname>Zend_Http_Client_Adapter_Curl</classname>
                     </para>
                 </listitem>
+
                 <listitem>
                     <para>
                         <classname>Zend_Http_Client_Adapter_Test</classname>
@@ -40,6 +45,7 @@
                 </listitem>
             </itemizedlist>
         </para>
+
         <para>
             <classname>Zend_Http_Client</classname> オブジェクトの接続アダプタを指定するには、
             設定オプション 'adapter' を使用します。
@@ -54,18 +60,22 @@
 
     <sect2 id="zend.http.client.adapters.socket">
         <title>ソケットアダプタ</title>
+
         <para>
             デフォルトの接続アダプタは <classname>Zend_Http_Client_Adapter_Socket</classname>
             です。明示的に接続アダプタを指定しない場合は、これが使用されます。
             Socket アダプタは <acronym>PHP</acronym> の組み込み関数 fsockopen()
             を使用しており、特別な拡張モジュールやコンパイルオプションは必要ありません。
         </para>
+
         <para>
             ソケットアダプタには、追加の設定オプションを指定できます。これは
             <classname>Zend_Http_Client->setConfig()</classname> で指定するか、
             あるいはクライアントのコンストラクタに渡します。
+
             <table id="zend.http.client.adapter.socket.configuration.table">
                 <title>Zend_Http_Client_Adapter_Socket の設定パラメータ</title>
+
                 <tgroup cols="4">
                     <thead>
                         <row>
@@ -75,43 +85,74 @@
                             <entry>デフォルト値</entry>
                         </row>
                     </thead>
+
                     <tbody>
                         <row>
                             <entry>persistent</entry>
-                            <entry>持続的な <acronym>TCP</acronym> 接続を使用するかどうか</entry>
+
+                            <entry>
+                                持続的な <acronym>TCP</acronym> 接続を使用するかどうか
+                            </entry>
+
                             <entry>boolean</entry>
                             <entry><constant>FALSE</constant></entry>
                         </row>
+
                         <row>
                             <entry>ssltransport</entry>
                             <entry><acronym>SSL</acronym> トランスポート層 (たとえば 'sslv2'、'tls')</entry>
                             <entry>文字列</entry>
                             <entry>ssl</entry>
                         </row>
+
                         <row>
                             <entry>sslcert</entry>
-                            <entry><acronym>PEM</acronym> でエンコードした、<acronym>SSL</acronym> 証明書ファイルへのパス</entry>
+
+                            <entry>
+                                <acronym>PEM</acronym> でエンコードした、<acronym>SSL</acronym> 証明書ファイルへのパス
+                            </entry>
+
                             <entry>文字列</entry>
                             <entry><constant>NULL</constant></entry>
                         </row>
+
                         <row>
                             <entry>sslpassphrase</entry>
-                            <entry><acronym>SSL</acronym> 証明書ファイルのパスフレーズ</entry>
+
+                            <entry>
+                                <acronym>SSL</acronym> 証明書ファイルのパスフレーズ
+                            </entry>
+
                             <entry>文字列</entry>
                             <entry><constant>NULL</constant></entry>
                         </row>
+
+                        <row>
+                            <entry>sslusecontext</entry>
+
+                            <!-- TODO : to be translated -->
+                            <entry>
+                                Enables proxied connections to use SSL even if
+                                the proxy connection itself does not.
+                            </entry>
+
+                            <entry>boolean</entry>
+                            <entry><constant>FALSE</constant></entry>
+                        </row>
                     </tbody>
                 </tgroup>
             </table>
 
             <note>
                 <title>持続的な TCP 接続</title>
+
                 <para>
                     持続的な <acronym>TCP</acronym> 接続を使用すると、<acronym>HTTP</acronym>
                     リクエストの処理速度が向上する可能性があります。
                     しかし、たいていの場合はその効果はごくわずかで、
                     接続先の <acronym>HTTP</acronym> サーバにかかる負荷が大きくなります。
                 </para>
+
                 <para>
                     持続的な <acronym>TCP</acronym> 接続を使用するのは、
                     同じサーバに頻繁に接続する場合で
@@ -119,6 +160,7 @@
                     いずれにせよ、このオプションを使用する前には
                     クライアント側の速度だけでなくサーバ側の負荷についてもベンチマークをとるようにしましょう。
                 </para>
+
                 <para>
                     さらに、持続的な接続を使用するときには
                     <xref linkend="zend.http.client.configuration" />
@@ -129,22 +171,27 @@
 
             <note>
                 <title>HTTPS SSL ストリームパラメータ</title>
+
                 <para>
                     <code>ssltransport, sslcert</code> および <code>sslpassphrase</code>
                     は、<acronym>HTTPS</acronym> 接続で使用する <acronym>SSL</acronym> レイヤーにのみ関連するものです。
                 </para>
+
                 <para>
                     たいていの場合はデフォルトの <acronym>SSL</acronym> 設定でうまく動作するでしょうが、
                     接続先のサーバが特別なクライアント設定を要求している場合は
                     それにあわせた設定をする必要があるかもしれません。
                     その場合は、
-                    <ulink url="http://www.php.net/manual/ja/transports.php#transports.inet">ここ</ulink>
+                    <ulink
+                        url="http://www.php.net/manual/ja/transports.php#transports.inet">ここ</ulink>
                     で <acronym>SSL</acronym> トランスポート層やオプションについての説明を参照ください。
                 </para>
             </note>
         </para>
+
         <example id="zend.http.client.adapters.socket.example-1">
             <title>HTTPS トランスポート層の変更</title>
+
             <programlisting language="php"><![CDATA[
 // 設定パラメータを指定します
 $config = array(
@@ -159,20 +206,23 @@ $client = new Zend_Http_Client('https://www.example.com', $config);
 $response = $client->request();
 ]]></programlisting>
         </example>
+
         <para>
             上の例の結果は、次の <acronym>PHP</acronym> コマンドで <acronym>TCP</acronym>
             接続をオープンした場合と同じになります。
         </para>
+
         <para>
             <methodname>fsockopen('tls://www.example.com', 443)</methodname>
         </para>
 
         <sect3 id="zend.http.client.adapters.socket.streamcontext">
             <title>ソケットアダプタのストリームコンテキストへのアクセスとカスタマイズ</title>
+
             <para>
                 Zend Framework 1.9 以降、<classname>Zend_Http_Client_Adapter_Socket</classname>
-                は、リモートサーバへの接続に使用している
-                <ulink url="http://www.php.net/manual/ja/stream.contexts.php">ストリームコンテキスト</ulink>
+                は、リモートサーバへの接続に使用している <ulink
+                    url="http://www.php.net/manual/ja/stream.contexts.php">ストリームコンテキスト</ulink>
                 に直接アクセスできるようになります。これを使用すると、
                 <acronym>TCP</acronym> ストリーム (<acronym>HTTPS</acronym> 接続の場合は <acronym>SSL</acronym> ラッパー)
                 固有のオプションやパラメータを渡せるようになります。
@@ -182,19 +232,21 @@ $response = $client->request();
                 ストリームコンテキストにアクセスするには、
                 <classname>Zend_Http_Client_Adapter_Socket</classname>
                 のこれらのメソッドを使用します。
+
                 <itemizedlist>
                     <listitem>
                         <para>
                             <firstterm><methodname>setStreamContext($context)</methodname></firstterm>
                             アダプタが使用するストリームコンテキストを設定します。
-                            <acronym>PHP</acronym> の
-                            <ulink url="http://php.net/manual/ja/function.stream-context-create.php"><methodname>stream_context_create()</methodname></ulink>
+                            <acronym>PHP</acronym> の <ulink
+                                url="http://php.net/manual/ja/function.stream-context-create.php"><methodname>stream_context_create()</methodname></ulink>
                             関数で作成したストリームコンテキストリソースか、
                             この関数に渡すのと同じ形式のストリームコンテキストオプションの配列のいずれかを指定できます。
                             配列を渡すと、そのオプションを用いて新たなストリームコンテキストを作成し、
                             それを設定します。
                         </para>
                     </listitem>
+
                     <listitem>
                         <para>
                             <firstterm><methodname>getStreamContext()</methodname></firstterm>
@@ -207,9 +259,11 @@ $response = $client->request();
                     </listitem>
                 </itemizedlist>
             </para>
+
             <example id="zend.http.client.adapters.socket.streamcontext.example-1">
-            <title>ソケットアダプタのストリームコンテキストオプションの設定</title>
-            <programlisting language="php"><![CDATA[
+                <title>ソケットアダプタのストリームコンテキストオプションの設定</title>
+
+                <programlisting language="php"><![CDATA[
 // オプションの配列
 $options = array(
     'socket' => array(
@@ -250,23 +304,24 @@ $response = $client->request();
 $opts = stream_context_get_options($adapter->getStreamContext());
 echo $opts['ssl']['peer_certificate'];
 ]]></programlisting>
-        </example>
+            </example>
 
-        <note>
-            <para>
-                ストリームコンテキストのオプションは、
-                アダプタが実際にリクエストを処理しだす前に設定しなければならないことに注意しましょう。
-                コンテキストを設定せずにソケットアダプタで <acronym>HTTP</acronym> リクエストを処理すると、
-                デフォルトのストリームコンテキストが作成されます。
-                リクエストを処理した後にこのコンテキストリソースにアクセスするには
-                <methodname>getStreamContext()</methodname> メソッドを使用します。
-            </para>
-        </note>
+            <note>
+                <para>
+                    ストリームコンテキストのオプションは、
+                    アダプタが実際にリクエストを処理しだす前に設定しなければならないことに注意しましょう。
+                    コンテキストを設定せずにソケットアダプタで <acronym>HTTP</acronym> リクエストを処理すると、
+                    デフォルトのストリームコンテキストが作成されます。
+                    リクエストを処理した後にこのコンテキストリソースにアクセスするには
+                    <methodname>getStreamContext()</methodname> メソッドを使用します。
+                </para>
+            </note>
         </sect3>
     </sect2>
 
     <sect2 id="zend.http.client.adapters.proxy">
         <title>プロキシアダプタ</title>
+
         <para>
             <classname>Zend_Http_Client_Adapter_Proxy</classname> アダプタはデフォルトのソケットアダプタとほぼ同じです。
             ただし、対象となるサーバに直接接続するのではなく
@@ -279,8 +334,10 @@ echo $opts['ssl']['peer_certificate'];
             プロキシアダプタを使用するには、
             デフォルトの 'adapter' オプション以外に
             いくつか追加のパラメータを設定する必要があります。
+
             <table id="zend.http.client.adapters.proxy.table">
                 <title>Zend_Http_Client の設定パラメータ</title>
+
                 <tgroup cols="4">
                     <thead>
                         <row>
@@ -290,6 +347,7 @@ echo $opts['ssl']['peer_certificate'];
                             <entry>値の例</entry>
                         </row>
                     </thead>
+
                     <tbody>
                         <row>
                             <entry>proxy_host</entry>
@@ -297,24 +355,28 @@ echo $opts['ssl']['peer_certificate'];
                             <entry>string</entry>
                             <entry>'proxy.myhost.com' あるいは '10.1.2.3'</entry>
                         </row>
+
                         <row>
                             <entry>proxy_port</entry>
                             <entry>プロキシサーバの <acronym>TCP</acronym> ポート</entry>
                             <entry>integer</entry>
                             <entry>8080 (デフォルト) あるいは 81</entry>
                         </row>
+
                         <row>
                             <entry>proxy_user</entry>
                             <entry>必要に応じて、プロキシのユーザ名</entry>
                             <entry>string</entry>
                             <entry>'shahar' あるいは指定しない場合は '' (デフォルト)</entry>
                         </row>
+
                         <row>
                             <entry>proxy_pass</entry>
                             <entry>必要に応じて、プロキシのパスワード</entry>
                             <entry>string</entry>
                             <entry>'secret' あるいは指定しない場合は '' (デフォルト)</entry>
                         </row>
+
                         <row>
                             <entry>proxy_auth</entry>
                             <entry>プロキシの <acronym>HTTP</acronym> 認証形式</entry>
@@ -325,12 +387,14 @@ echo $opts['ssl']['peer_certificate'];
                 </tgroup>
             </table>
         </para>
+
         <para>
             proxy_host は常に設定しなければなりません。指定しなかった場合は、
             自動的に <classname>Zend_Http_Client_Adapter_Socket</classname> による直接接続に切り替わります。
             proxy_port のデフォルトは '8080' です。もし別のポートをプロキシで使用している場合は、
             適切に設定する必要があります。
         </para>
+
         <para>
             proxy_user および proxy_pass は、
             プロキシサーバが認証を必要とする場合にのみ設定します。
@@ -338,14 +402,17 @@ echo $opts['ssl']['peer_certificate'];
             ヘッダがリクエストに追加されます。プロキシで認証を必要としない場合は、
             このふたつのオプションはそのままにしておきます。
         </para>
+
         <para>
             proxy_auth は、プロキシが認証を必要としている場合に、
             その認証形式を指定します。設定できる値は
             Zend_Http_Client::setAuth() メソッドと同じです。現在はベーシック認証
             (Zend_Http_Client::AUTH_BASIC) のみをサポートしています。
         </para>
+
         <example id="zend.http.client.adapters.proxy.example-1">
             <title>プロキシサーバを使用した Zend_Http_Client の使用法</title>
+
             <programlisting language="php"><![CDATA[
 // 接続パラメータを設定します
 $config = array(
@@ -362,6 +429,7 @@ $client = new Zend_Http_Client('http://www.example.com', $config);
 // 作業を続けます...
 ]]></programlisting>
         </example>
+
         <para>
             説明したとおり、もし proxy_host を省略したり空文字列を設定したりすると、
             自動的に直接接続に切り替わります。これにより、設定パラメータによって
@@ -381,6 +449,7 @@ $client = new Zend_Http_Client('http://www.example.com', $config);
 
     <sect2 id="zend.http.client.adapters.curl">
         <title>cURL アダプタ</title>
+
         <para>
             cURL は標準的な <acronym>HTTP</acronym> クライアントライブラリで、
             多くの OS に含まれています。また <acronym>PHP</acronym> からは cURL
@@ -393,6 +462,7 @@ $client = new Zend_Http_Client('http://www.example.com', $config);
 
         <example id="zend.http.client.adapters.curl.example-1">
             <title>cURL オプションの設定</title>
+
             <programlisting language="php"><![CDATA[
 $config = array(
     'adapter'   => 'Zend_Http_Client_Adapter_Curl',
@@ -441,17 +511,20 @@ $client->request("PUT");
 
     <sect2 id="zend.http.client.adapters.test">
         <title>テストアダプタ</title>
+
         <para>
             <acronym>HTTP</acronym> 接続に依存するテストコードを書くのは非常に難しいものです。
             たとえば、リモートサーバから <acronym>RSS</acronym> を取得するアプリケーションをテストするには、
             ネットワークにつながっている必要があります。常にネットワークが使用できるとは限りません。
         </para>
+
         <para>
             このようなときのためにあるのが <classname>Zend_Http_Client_Adapter_Test</classname> アダプタです。
             <classname>Zend_Http_Client</classname> を使用するアプリケーションを作成し、それをテストしたい場合には、
             デフォルトのアダプタを Test アダプタ (モックオブジェクト) に変更します。
             これで、サーバに接続せずにテストを行えるようになります。
         </para>
+
         <para>
             <classname>Zend_Http_Client_Adapter_Test</classname> には setResponse() というメソッドがあります。
             このメソッドのパラメータには、<acronym>HTTP</acronym> レスポンスをテキストか
@@ -459,8 +532,10 @@ $client->request("PUT");
             レスポンスを設定すると、Test アダプタは常にこのレスポンスを返すようになります。
             実際の <acronym>HTTP</acronym> リクエストは行いません。
         </para>
+
         <example id="zend.http.client.adapters.test.example-1">
             <title>HTTP レスポンススタブを使用したテスト</title>
+
             <programlisting language="php"><![CDATA[
 // 新しいアダプタとクライアントのインスタンスを作成します
 $adapter = new Zend_Http_Client_Adapter_Test();
@@ -487,6 +562,7 @@ $response = $client->request('GET');
 // .. $response の処理を続けます...
 ]]></programlisting>
         </example>
+
         <para>
             上の例のようにすると、<acronym>HTTP</acronym> クライアントにお望みのレスポンスを返させることができます。
             その際にネットワーク接続は使用しません。また、実際のサーバからのレスポンスも使用しません。
@@ -500,8 +576,10 @@ $response = $client->request('GET');
             setResponse() を単独で使うことはできません。なぜなら、
             結果が呼び出し元に返ってくるまで次のレスポンスを設定できないからです。
         </para>
+
         <example id="zend.http.client.adapters.test.example-2">
             <title>複数の HTTP レスポンススタブを使用したテスト</title>
+
             <programlisting language="php"><![CDATA[
 // 新しいアダプタおよびクライアントのインスタンスを作成します
 $adapter = new Zend_Http_Client_Adapter_Test();
@@ -534,17 +612,20 @@ $adapter->addResponse(
 // オブジェクトに注入し、オブジェクトの動きを以下でテストします
 ]]></programlisting>
         </example>
+
         <para>
             setResponse() メソッドは、
             <classname>Zend_Http_Client_Adapter_Test</classname> のバッファにあるレスポンスをすべて削除し、
             最初に返されるレスポンスを設定します。addResponse()
             メソッドは、それに続くレスポンスを追加します。
         </para>
+
         <para>
             レスポンスは、それを追加した順に再生されます。
             登録したよりも多くのリクエストが発生した場合は、
             返されるレスポンスは最初のものに戻り、そこからまた順に返されるようになります。
         </para>
+
         <para>
             上の例で、このアダプタがテストするように設定されているのは、
             302 リダイレクトが発生した場合のオブジェクトの挙動です。
@@ -556,6 +637,7 @@ $adapter->addResponse(
             テストアダプタを設定し終えたら、そのアダプタを含む <acronym>HTTP</acronym>
             クライアントをテスト対象オブジェクトに注入し、その挙動をテストします。
         </para>
+
         <para>
             アダプタをわざと失敗させたい場合は
             <methodname>setNextRequestWillFail($flag)</methodname> を使用します。
@@ -564,8 +646,10 @@ $adapter->addResponse(
             を発生させます。これは、外部のサイトのコンテンツをキャッシュするアプリケーションで、
             (外部サイトがダウンしていたときの) 挙動をテストする際に有用です。
         </para>
+
         <example id="zend.http.client.adapters.test.example-3">
             <title>アダプタを失敗させる</title>
+
             <programlisting language="php"><![CDATA[
 // 新たなアダプタとクライアントを作成します
 $adapter = new Zend_Http_Client_Adapter_Test();
@@ -574,7 +658,7 @@ $client = new Zend_Http_Client('http://www.example.com', array(
 ));
 
 // 次のリクエストでわざと例外を発生させます
-$adapter->nextRequestWillFail(true);
+$adapter->setNextRequestWillFail(true);
 
 try {
     // これは Zend_Http_Client_Adapter_Exception となります
@@ -591,12 +675,14 @@ try {
 
     <sect2 id="zend.http.client.adapters.extending">
         <title>独自の接続アダプタの作成</title>
+
         <para>
             独自の接続アダプタを作成し、それを使用することもできます。
             たとえば持続的なソケットを使用するアダプタを作成したり、
             キャッシュ機能を追加したアダプタを作成したりなど、
             作成するアプリケーションの要件にあわせたものを作成することが可能です。
         </para>
+
         <para>
             そのためには、<classname>Zend_Http_Client_Adapter_Interface</classname>
             を実装したクラスを作成する必要があります。
@@ -604,8 +690,10 @@ try {
             この例で定義されているすべてのパブリック関数を、
             アダプタで定義する必要があります。
         </para>
+
         <example id="zend.http.client.adapters.extending.example-1">
             <title>独自の接続アダプタの作成</title>
+
             <programlisting language="php"><![CDATA[
 class MyApp_Http_Client_Adapter_BananaProtocol
     implements Zend_Http_Client_Adapter_Interface

documentation/manual/ja/module_specs/Zend_Http_Client.xml

@@ -1,8 +1,9 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!-- Reviewed: no -->
-<!-- EN-Revision: 17230 -->
+<!-- EN-Revision: 21018 -->
 <sect1 id="zend.http.client">
     <title>導入</title>
+
     <para>
         <classname>Zend_Http_Client</classname> は、Hyper-Text Transfer Protocol (<acronym>HTTP</acronym>)
         リクエストを簡単に扱うためのインターフェイスを提供します。
@@ -12,16 +13,20 @@
         オブジェクトを返します。これを使用すると、レスポンスのヘッダや本文にアクセスできます
         (<xref linkend="zend.http.response" /> を参照ください)。
     </para>
+
     <sect2 id="zend.http.client.usage">
         <title>Zend_Http_Client の使用法</title>
+
         <para>
-            クラスのコンストラクタには、オプションの引数として URL を指定することができます
+            クラスのコンストラクタには、オプションの引数として URL を指定できます
             (文字列か Zend_Uri_Http オブジェクトのどちらでも可能です)。
             また、配列あるいは Zend_Config オブジェクトで設定オプションを指定することもできます。
             どちらも省略することが可能で、その場合は後から
             setUri() メソッドや setConfig() メソッドで指定します。
+
             <example id="zend.http.client.introduction.example-1">
                 <title>Zend_Http_Client のインスタンスの作成</title>
+
                 <programlisting language="php"><![CDATA[
 $client = new Zend_Http_Client('http://example.org', array(
     'maxredirects' => 0,
@@ -41,25 +46,31 @@ $client->setConfig($config);
             </example>
 
             <note>
-                <para>Zend_Http_Client は Zend_Uri_Http を用いて URL を検証します。
-                つまり、URL 中にあるパイプ記号 ('|') やキャレット記号 ('^')
-                などの特殊文字はデフォルトでは許可されないということです。
-
-                これを変更するには、Zend_Uri のオプション 'allow_unwise' を
-                'true' に設定します。詳細は <xref linkend="zend.uri.validation.allowunwise" />
-                を参照ください。</para>
+                <para>
+                    Zend_Http_Client は Zend_Uri_Http を用いて URL を検証します。
+                    つまり、URL 中にあるパイプ記号 ('|') やキャレット記号 ('^')
+                    などの特殊文字はデフォルトでは許可されないということです。
+                    これを変更するには、Zend_Uri のオプション 'allow_unwise' を
+                    '<constant>TRUE</constant>' に設定します。詳細は <xref
+                        linkend="zend.uri.validation.allowunwise" />
+                    を参照ください。
+                </para>
             </note>
         </para>
     </sect2>
+
     <sect2 id="zend.http.client.configuration">
         <title>設定パラメータ</title>
+
         <para>
             コンストラクタおよび setConfig() メソッドでは、
             設定パラメータの連想配列あるいは <classname>Zend_Config</classname> オブジェクトを受け取ります。
             これらのパラメータは、設定してもしなくてもかまいません。
             すべてのパラメータにはデフォルト値があります。
+
             <table id="zend.http.client.configuration.table">
                 <title>Zend_Http_Client の設定パラメータ</title>
+
                 <tgroup cols="4">
                     <thead>
                         <row>
@@ -69,6 +80,7 @@ $client->setConfig($config);
                             <entry>デフォルト値</entry>
                         </row>
                     </thead>
+
                     <tbody>
                         <row>
                             <entry>maxredirects</entry>
@@ -76,94 +88,136 @@ $client->setConfig($config);
                             <entry>integer</entry>
                             <entry>5</entry>
                         </row>
+
                         <row>
                             <entry>strict</entry>
-                            <entry>ヘッダ名の検証を行うかどうか。false に設定すると、検証関数をスキップします。通常はこれを変更してはいけません。</entry>
+                            <entry>
+                                ヘッダ名の検証を行うかどうか。
+                                <constant>FALSE</constant> に設定すると、検証関数をスキップします。
+                                通常はこれを変更してはいけません。
+                            </entry>
                             <entry>boolean</entry>
-                            <entry>true</entry>
+                            <entry><constant>TRUE</constant></entry>
                         </row>
+
                         <row>
                             <entry>strictredirects</entry>
-                            <entry>リダイレクトの際に RFC に厳密に従うかどうか (<xref linkend="zend.http.client.redirections" /> を参照ください)</entry>
+                            <entry>
+                                リダイレクトの際に RFC に厳密に従うかどうか (<xref
+                                    linkend="zend.http.client.redirections" /> を参照ください)
+                            </entry>
                             <entry>boolean</entry>
-                            <entry>false</entry>
+                            <entry><constant>FALSE</constant></entry>
                         </row>
+
                         <row>
                             <entry>useragent</entry>
                             <entry>ユーザエージェントを表す文字列 (リクエストヘッダに付加されます)</entry>
                             <entry>string</entry>
                             <entry>'Zend_Http_Client'</entry>
                         </row>
+
                         <row>
                             <entry>timeout</entry>
                             <entry>接続タイムアウト秒数</entry>
                             <entry>integer</entry>
                             <entry>10</entry>
                         </row>
+
                         <row>
                             <entry>httpversion</entry>
                             <entry><acronym>HTTP</acronym> プロトコルのバージョン (通常は '1.1' あるいは '1.0')</entry>
                             <entry>string</entry>
                             <entry>'1.1'</entry>
                         </row>
+
                         <row>
                             <entry>adapter</entry>
-                            <entry>使用する接続アダプタクラス (<xref linkend="zend.http.client.adapters" /> を参照ください)</entry>
+                            <entry>
+                                使用する接続アダプタクラス (<xref
+                                    linkend="zend.http.client.adapters" /> を参照ください)
+                            </entry>
                             <entry>mixed</entry>
                             <entry>'Zend_Http_Client_Adapter_Socket'</entry>
                         </row>
+
                         <row>
                             <entry>keepalive</entry>
                             <entry>
-                             サーバとの keep-alive 接続を有効にするかどうか。
-                             同一サーバに連続してリクエストが発生する場合などに便利で、性能を向上させるでしょう。
+                                 サーバとの keep-alive 接続を有効にするかどうか。
+                                 同一サーバに連続してリクエストが発生する場合などに便利で、
+                                 性能を向上させるでしょう。
                             </entry>
                             <entry>boolean</entry>
-                            <entry>false</entry>
+                            <entry><constant>FALSE</constant></entry>
                         </row>
+
                         <row>
                             <entry>storeresponse</entry>
-                            <entry>直近のレスポンスを保存して後から
-                            <methodname>getLastResponse()</methodname> で取得できるようにするかどうか。false の場合
-                            <methodname>getLastResponse()</methodname> は null を返します。</entry>
+                            <entry>
+                                直近のレスポンスを保存して後から
+                                <methodname>getLastResponse()</methodname> で取得できるようにするかどうか。
+                                <constant>FALSE</constant> の場合、
+                                <methodname>getLastResponse()</methodname> は <constant>NULL</constant> を返します。
+                            </entry>
+                            <entry>boolean</entry>
+                            <entry><constant>TRUE</constant></entry>
+                        </row>
+
+                        <!-- TODO : to be translated -->
+                        <row>
+                            <entry>encodecookies</entry>
+                            <entry>Whether to pass the cookie value through urlencode/urldecode.
+                            Enabling this breaks support with some web servers.
+                            Disabling this limits the range of values the cookies can contain.</entry>
                             <entry>boolean</entry>
-                            <entry>true</entry>
+                            <entry><constant>TRUE</constant></entry>
                         </row>
                     </tbody>
                 </tgroup>
             </table>
         </para>
     </sect2>
+
     <sect2 id="zend.http.client.basic-requests">
         <title>基本的な HTTP リクエストの処理</title>
+
         <para>
             シンプルな <acronym>HTTP</acronym> リクエストを実行するのは非常に簡単で、単に
             request() メソッドを実行するだけです。たったの三行ですんでしまいます。
+
             <example id="zend.http.client.basic-requests.example-1">
                 <title>シンプルな GET リクエストの処理</title>
+
                 <programlisting language="php"><![CDATA[
 $client = new Zend_Http_Client('http://example.org');
 $response = $client->request();
 ]]></programlisting>
             </example>
-            request() メソッドには、オプションでパラメータを指定することができます。
+
+            request() メソッドには、オプションでパラメータを指定できます。
             このパラメータはリクエストメソッドで、<acronym>HTTP</acronym> プロトコルで定義されている
             GET、POST、PUT、HEAD、DELETE、TRACE、OPTIONS そして CONNECT
             のいずれかを指定可能です。
+
             <footnote>
               <para>
                 RFC 2616 - <ulink url="http://www.w3.org/Protocols/rfc2616/rfc2616.html" /> を参照ください。
               </para>
-            </footnote>.
+            </footnote>
+
             利便性を高めるため、これらはすべてクラス定数として定義されています。たとえば
             Zend_Http_Client::GET、Zend_Http_Client::POST などのようになっています。
         </para>
+
         <para>
             メソッドを指定しない場合は、直近の setMethod() コールで指定されたメソッドを使用します。
             setMethod() もコールされていない場合は、デフォルトのリクエストメソッドとして
             GET を使用します (上の例を参照ください)。
+
             <example id="zend.http.client.basic-requests.example-2">
                 <title>GET 以外のリクエストメソッドの使用</title>
+
                 <programlisting language="php"><![CDATA[
 // POST リクエストを実行します
 $response = $client->request('POST');
@@ -178,6 +232,7 @@ $response = $client->request();
 
     <sect2 id="zend.http.client.parameters">
         <title>GET や POST へのパラメータの追加</title>
+
         <para>
             GET パラメータを <acronym>HTTP</acronym> リクエストに追加するのは簡単です。
             URL の一部として指定するか、あるいは setParameterGet() メソッドを使用します。
@@ -186,8 +241,10 @@ $response = $client->request();
             さらに便利に使用するため、setParameterGet()
             メソッドでは name => value 形式の連想配列で GET 変数を指定することもできます。
             これは、複数の GET パラメータを指定する必要がある場合に便利です。
+
             <example id="zend.http.client.parameters.example-1">
                 <title>GET パラメータの設定</title>
+
                 <programlisting language="php"><![CDATA[
 // setParameterGet メソッドで GET パラメータを指定します
 $client->setParameterGet('knight', 'lancelot');
@@ -204,6 +261,7 @@ $client->setParameterGet(array(
 ]]></programlisting>
             </example>
         </para>
+
         <para>
             GET パラメータはあらゆるリクエストメソッドで送信できますが、
             POST パラメータは POST リクエストの本文としてしか送信できません。
@@ -211,8 +269,10 @@ $client->setParameterGet(array(
             パラメータを追加する場合と非常に似ています。
             使用するのは setParameterPost() メソッドで、このメソッドの使用法は
             setParameterGet() メソッドと同じです。
+
             <example id="zend.http.client.parameters.example-2">
                 <title>POST パラメータの設定</title>
+
                 <programlisting language="php"><![CDATA[
 // POST パラメータを設定します
 $client->setParameterPost('language', 'fr');
@@ -225,6 +285,7 @@ $client->setParameterPost(array(
 ));
 ]]></programlisting>
             </example>
+
             POST リクエストを送信する際には、GET パラメータと POST
             パラメータの両方を設定できることに注意しましょう。
             一方、POST パラメータを POST 以外のリクエストで指定しても何のエラーも発生しませんが、
@@ -235,6 +296,7 @@ $client->setParameterPost(array(
 
     <sect2 id="zend.http.client.accessing_last">
         <title>直近のリクエストやレスポンスへのアクセス</title>
+
         <para>
             <classname>Zend_Http_Client</classname> では、そのクライアントオブジェクトが
             直近に送信したリクエストおよび