Zend_File_Transfer の API は日々変わっています。
Zend_File_Transfer やそのサブコンポーネントを
初期のバージョンから使っている方は、以下のガイドラインに従ってスクリプトを変更し、
新しい API にあわせましょう。
Zend_File_Transfer のバリデータが
Zend_Config と組み合わせて使えないという指摘がありました。
名前つき配列を使っていなかったからです。
そこで、Zend_File_Transfer 用のすべてのフィルタとバリデータを作り直しました。
古い構文でも動作しますがこれは非推奨となり、
設定せずに実行すると PHP の notice が発生するようになります。
次のリストは、パラメータの使用法に関する変更点をまとめたものです。
古い形式の API: Zend_Filter_File_Rename($oldfile, $newfile, $overwrite)
新しい形式の API: Zend_Filter_File_Rename($options)
$options には次の配列キーを使えます。
source ($oldfile と同等)、
target ($newfile と同等)、
overwrite ($overwrite と同等)
例 19.31. rename フィルタの 1.6 から 1.7 での変更点
// 1.6 の例
$upload = new Zend_File_Transfer_Adapter_Http();
$upload->addFilter('Rename',
array('/path/to/oldfile', '/path/to/newfile', true));
// 1.7 の例
$upload = new Zend_File_Transfer_Adapter_Http();
$upload->addFilter('Rename',
array('source' => '/path/to/oldfile',
'target' => '/path/to/newfile',
'overwrite' => true));
古い形式の API: Zend_Validate_File_Count($min, $max)
新しい形式の API: Zend_Validate_File_Count($options)
$options には次の配列キーを使えます。
min ($min と同等)、
max ($max と同等)
例 19.32. count バリデータの 1.6 から 1.7 での変更点
// 1.6 の例
$upload = new Zend_File_Transfer_Adapter_Http();
$upload->addValidator('Count',
array(2, 3));
// 1.7 の例
$upload = new Zend_File_Transfer_Adapter_Http();
$upload->addValidator('Count',
false,
array('min' => 2,
'max' => 3));
古い形式の API: Zend_Validate_File_Extension($extension, $case)
新しい形式の API: Zend_Validate_File_Extension($options)
$options には次の配列キーを使えます。
* ($extension と同等、任意の他のキーを使用可能)、
case ($case と同等)
例 19.33. extension バリデータの 1.6 から 1.7 での変更点
// 1.6 の例
$upload = new Zend_File_Transfer_Adapter_Http();
$upload->addValidator('Extension',
array('jpg,gif,bmp', true));
// 1.7 の例
$upload = new Zend_File_Transfer_Adapter_Http();
$upload->addValidator('Extension',
false,
array('extension1' => 'jpg,gif,bmp',
'case' => true));
古い形式の API: Zend_Validate_File_FilesSize($min, $max, $bytestring)
新しい形式の API: Zend_Validate_File_FilesSize($options)
$options には次の配列キーを使えます。
min ($min と同等)、
max ($max と同等)、
bytestring ($bytestring と同等)
さらに useByteString() メソッドのシグネチャも変わりました。
このメソッドの使用法は、
そのバリデータが生成するメッセージでバイト文字列を使うことを想定しているかどうかを調べるだけになりました。
フラグの値を設定するには
setUseByteString() メソッドを使用します。
例 19.34. filessize バリデータの 1.6 から 1.7 での変更点
// 1.6 の例
$upload = new Zend_File_Transfer_Adapter_Http();
$upload->addValidator('FilesSize',
array(100, 10000, true));
// 1.7 の例
$upload = new Zend_File_Transfer_Adapter_Http();
$upload->addValidator('FilesSize',
false,
array('min' => 100,
'max' => 10000,
'bytestring' => true));
// 1.6 の例
$upload->useByteString(true); // set flag
// 1.7 の例
$upload->setUseByteSting(true); // set flag
古い形式の API: Zend_Validate_File_Hash($hash, $algorithm)
新しい形式の API: Zend_Validate_File_Hash($options)
$options には次の配列キーを使えます。
* ($hash と同等、任意の他のキーを使用可能)、
algorithm ($algorithm と同等)、
例 19.35. hash バリデータの 1.6 から 1.7 での変更点
// 1.6 の例
$upload = new Zend_File_Transfer_Adapter_Http();
$upload->addValidator('Hash',
array('12345', 'md5'));
// 1.7 の例
$upload = new Zend_File_Transfer_Adapter_Http();
$upload->addValidator('Hash',
false,
array('hash1' => '12345',
'algorithm' => 'md5'));
古い形式の API: Zend_Validate_File_ImageSize($minwidth, $minheight, $maxwidth, $maxheight)
新しい形式の API: Zend_Validate_File_FilesSize($options)
$options には次の配列キーを使えます。
minwidth ($minwidth と同等)、
maxwidth ($maxwidth と同等)、
minheight ($minheight と同等)、
maxheight ($maxheight と同等)
例 19.36. imagesize バリデータの 1.6 から 1.7 での変更点
// 1.6 の例
$upload = new Zend_File_Transfer_Adapter_Http();
$upload->addValidator('ImageSize',
array(10, 10, 100, 100));
// 1.7 の例
$upload = new Zend_File_Transfer_Adapter_Http();
$upload->addValidator('ImageSize',
false,
array('minwidth' => 10,
'minheight' => 10,
'maxwidth' => 100,
'maxheight' => 100));
古い形式の API: Zend_Validate_File_Size($min, $max, $bytestring)
新しい形式の API: Zend_Validate_File_Size($options)
$options には次の配列キーを使えます。
min ($min と同等)、
max ($max と同等)、
bytestring ($bytestring と同等)
例 19.37. size バリデータの 1.6 から 1.7 での変更点
// 1.6 の例
$upload = new Zend_File_Transfer_Adapter_Http();
$upload->addValidator('Size',
array(100, 10000, true));
// 1.7 の例
$upload = new Zend_File_Transfer_Adapter_Http();
$upload->addValidator('Size',
false,
array('min' => 100,
'max' => 10000,
'bytestring' => true));
Zend_File_Transfer のバリデータが
Zend_Form のデフォルトのものと同じようには動作しないという指摘がありました。
Zend_Form では breakChainOnFailure
パラメータを利用でき、検証エラーが発生した際に
それ以降のバリデータを動作させないようにすることができます。
そこで、Zend_File_Transfer
の既存のバリデータにもこのパラメータを追加することにしました。
古い形式の API: addValidator($validator, $options, $files).
新しい形式の API: addValidator($validator, $breakChainOnFailure, $options, $files).
既存のスクリプトを新しい API に移行するには、バリデータの定義の後に
false を追加します。
例 19.38. ファイルバリデータを 1.6.1 から 1.6.2 に移行する方法
// 1.6.1 での例
$upload = new Zend_File_Transfer_Adapter_Http();
$upload->addValidator('FilesSize', array('1B', '100kB'));
// 同じ例を 1.6.2 以降用にしたもの
// boolean false が追加されていることに注意しましょう
$upload = new Zend_File_Transfer_Adapter_Http();
$upload->addValidator('FilesSize', false, array('1B', '100kB'));