Zend Framework 1.9
以前のバージョンから Zend Framework 1.9 またはそれ以降に更新する際は、
下記の移行上の注意点に注意すべきです。
Zend_File_Transfer
MimeType の検証
セキュリティ上の理由から、
MimeType、ExcludeMimeType、
IsCompressed および IsImage
バリデータにおけるデフォルトのフォールバック機能を無効にしました。
つまり、fileInfo 拡張モジュールあるいは
magicMime 拡張モジュールがなければ、
検証が常に失敗するようになるということです。
ユーザ側から渡された HTTP フィールドを使用して入力を検証する必要がある場合は、
enableHeaderCheck() メソッドを使用すればこの機能を有効にできます。
セキュリティに関するヒント
ユーザ側から渡された HTTP
フィールドに依存するのはセキュリティ上のリスクとなることに注意しましょう。
これは簡単に改ざんすることができ、悪意のあるファイルを受け取る可能性があります。
HTTP フィールドの使用を許可する
true);
// あるいは後から
$valid->enableHeaderCheck();
]]>
Zend_Filter
1.9のリリース以前は、Zend_Filterでは、
static get()メソッドを使うことができました。
リリース1.9と同時に、このメソッドは、より描写的な
filterStatic()に名前を変更されました。
古い get() メソッドは非推奨に区分されます。
Zend_Http_Client
内部のアップロードされたファイル情報ストレージに変更
Zend Framework のバージョン 1.9 では、
アップロードされるファイルに関する情報を
Zend_Http_Clientが内部的に格納し、
Zend_Http_Client::setFileUpload()メソッドを用いてセットする
方法で変化がありました。
複数のファイルを同じフォーム名で
ファイルの配列としてアップロードできるように
この変化が取り入れられました。
この問題に関するより多くの情報は、このバグ・レポート
で見つけられます。
アップロードされたファイル情報の内部ストレージ
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_Locale
非推奨となるメソッド
特別に用意されていたメソッドのいくつかが非推奨となります。
既存の挙動と重複しているからです。
古いメソッドも動作するにはしますが、
新しいメソッドについて説明する user notice が発生することに注意しましょう。
これらのメソッドは 2.0 で削除されます。
次の一覧で、新旧のメソッドコールを参照ください。
新旧のメソッドコールの一覧
古い方法
新しい方法
getLanguageTranslationList($locale)
getTranslationList('language', $locale)
getScriptTranslationList($locale)
getTranslationList('script', $locale)
getCountryTranslationList($locale)
getTranslationList('territory', $locale, 2)
getTerritoryTranslationList($locale)
getTranslationList('territory', $locale, 1)
getLanguageTranslation($value, $locale)
getTranslation($value, 'language', $locale)
getScriptTranslation($value, $locale)
getTranslation($value, 'script', $locale)
getCountryTranslation($value, $locale)
getTranslation($value, 'country', $locale)
getTerritoryTranslation($value, $locale)
getTranslation($value, 'territory', $locale)
Zend_View_Helper_Navigation
1.9のリリースより前は、
メニュー・ヘルパー (Zend_View_Helper_Navigation_Menu) は、
サブメニューを正しく生成しませんでした。
onlyActiveBranch が TRUE で、
オプションの renderParents が FALSE のとき、
もし、最も深いアクティブなページが minDepth オプションより低い階層にあると、
何もレンダリングされないでしょう。
より簡単に言うと、もし minDepth が 1 に設定され、
アクティブなページが最初のレベルのページの一つなら、
以下の例が示すように、何もレンダリングされないでしょう。
下記のコンテナのセットアップを考えて見ましょう。
'Home',
'uri' => '#'
),
array(
'label' => 'Products',
'uri' => '#',
'active' => true,
'pages' => array(
array(
'label' => 'Server',
'uri' => '#'
),
array(
'label' => 'Studio',
'uri' => '#'
)
)
),
array(
'label' => 'Solutions',
'uri' => '#'
)
));
]]>
下記のコードがビュースクリプトで使用されます。
navigation()->menu()->renderMenu($container, array(
'minDepth' => 1,
'onlyActiveBranch' => true,
'renderParents' => false
)); ?>
]]>
リリース1.9より前は、上記のコードスニペットは、何も出力しません。
リリース1.9以降では、ページの子供がある限り、
Zend_View_Helper_Navigation_Menu の _renderDeepestMenu()
メソッドは minDepth の１階層下のアクティブページを受け取ります。
今では、同じコードスニペットで下記を出力します。
Server
Studio
]]>