Programmer's Reference Guide
| Zend_Http_Client - 接続アダプタ |
前バージョンからの移行
Zend_Http_Clientの外部 API は Zend Framework の 1.x ブランチと整合したままですが、 Zend_Http_Clientとその関連したクラスの内部構造に若干の変化がもたらされました。
これらの変化は、Zend_Http_Clientを用いたコードに影響すべきではありません しかし、オーバーロードするか、または拡張するPHPクラスに影響するかもしれません。 アプリケーションがZend_Http_Clientをサブクラスとするなら、 Zend Frameworkをアップグレードする前に以下の変化に目を通すことを大いに勧めます。
1.8 以前から 1.9 以降への移行
内部のアップロードされたファイル情報ストレージに変更
Zend Framework のバージョン 1.9 では、 アップロードされるファイルに関する情報を Zend_Http_Clientが内部的に格納し、 Zend_Http_Client::setFileUpload()メソッドを用いてセットする 方法で変化がありました。
複数のファイルを同じフォーム名で ファイルの配列としてアップロードできるように この変化が取り入れられました。 この問題に関するより多くの情報は、 » このバグ・レポート で見つけることができます。
例1 アップロードされたファイル情報の内部ストレージ
- // ファイル２つを同じフォーム要素名でファイルの配列としてアップロード
- $client = new Zend_Http_Client();
- $client->setFileUpload('file1.txt',
- 'userfile[]',
- 'some raw data',
- 'text/plain');
- $client->setFileUpload('file2.txt',
- 'userfile[]',
- 'some other data',
- 'application/octet-stream');
- // Zend Framework の 1.8 以前では、
- // protected メンバー $client->files の値はこうです:
- // $client->files = array(
- // 'userfile[]' => array('file2.txt',
- 'application/octet-stream',
- 'some other data')
- // );
- // Zend Framework の 1.9 以降では、$client->files の値はこうです:
- // $client->files = array(
- // array(
- // 'formname' => 'userfile[]',
- // 'filename' => 'file1.txt,
- // 'ctype' => 'text/plain',
- // 'data' => 'some raw data'
- // ),
- // array(
- // 'formname' => 'userfile[]',
- // 'filename' => 'file2.txt',
- // 'formname' => 'application/octet-stream',
- // 'formname' => 'some other data'
- // )
- // );
ご覧の通り、この変化は1つ以上のファイルで同じフォーム要素名を使えるようにします。 しかし、それは微妙な下位互換性変化を取り入れるので、そのように注意するべきです。
Zend_Http_Client::_getParametersRecursive() の廃止
バージョン1.9から始まりますが、 protected メソッド _getParametersRecursive() はもはや Zend_Http_Client に使われず、廃止されます。 それを使うと、E_NOTICE メッセージがPHPによって発生する原因になります。
Zend_Http_Clientをサブクラスとして、このメソッドを呼ぶなら、 その代わりに Zend_Http_Client::_flattenParametersArray() static メソッドを使用することに目を向けるべきです。
また、この_getParametersRecursiveは protected メソッドなので、 この変化はZend_Http_Clientをサブクラスとするユーザーに 影響を及ぼすだけです。
| Zend_Http_Client - 接続アダプタ |