Programmer's Reference Guide
| Filter für Zend_File_Transfer |
Migration von vorhergehenden Versionen
Die API von Zend_File_Transfer wurde von Zeit zu Zeit verändert. Wenn man bereits
angefangen hat Zend_File_Transfer und dessen Subkomponenten in vorhergehenden Versionen
zu verwenden sollte man den anbei beschriebenen Richtlinien folgen um eigene Skripts auf die neue
API zu migrieren.
Migration von 1.6 zu 1.7 oder neuer
Änderungen bei der Verwendung von Filtern und Prüfungen
Wie von Benutzern erwähnt, arbeiteten die Prüfungen von Zend_File_Transfer
nicht in Verbindung mit Zend_Config zusammen, durch den Fakt das Sie keine
benannten Arrays verwendet haben.
Deswegen wurden alle Filter und Prüfungen für Zend_File_Transfer überarbeitet.
Wärend die alten Signaturen weiterhin funktionieren, wurden sie als veraltet markiert, und
werfen eine PHP Notiz mit der Aufforderung das zu beheben.
Die folgende Liste zeigt die Änderungen und was für die richtige Verwendung der Parameter getan werden muß.
Filter: Rename
Alte API der Methode:
Zend_Filter_File_Rename($oldfile, $newfile, $overwrite)Neue API der Methode:
Zend_Filter_File_Rename($options)wobei $options die folgenden Schlüssel für das Array akzeptiert: source identisch mit $oldfile, target identisch mit $newfile, overwrite identisch mit $overwrite
Beispiel #1 Änderungen für den Rename Filter von 1.6 zu 1.7
// Beispiel für 1.6
$upload = new Zend_File_Transfer_Adapter_Http();
$upload->addFilter('Rename',
array('/path/to/oldfile', '/path/to/newfile', true));
// Gleiches Beispiel für 1.7
$upload = new Zend_File_Transfer_Adapter_Http();
$upload->addFilter('Rename',
array('source' => '/path/to/oldfile',
'target' => '/path/to/newfile',
'overwrite' => true));
Prüfung: Count
Alte API der Methode:
Zend_Validate_File_Count($min, $max)Neue API der Methode:
Zend_Validate_File_Count($options)wobei $options die folgenden Schlüssel für das Array akzeptiert: min identisch mit $min, max identisch mit $max,
Beispiel #2 Änderungen für die Count Prüfung von 1.6 zu 1.7
// Beispiel für 1.6
$upload = new Zend_File_Transfer_Adapter_Http();
$upload->addValidator('Count',
array(2, 3));
// Gleiches Beispiel für 1.7
$upload = new Zend_File_Transfer_Adapter_Http();
$upload->addValidator('Count',
false,
array('min' => 2,
'max' => 3));
Prüfung: Extension
Alte API der Methode:
Zend_Validate_File_Extension($extension, $case)Neue API der Methode:
Zend_Validate_File_Extension($options)wobei $options die folgenden Schlüssel für das Array akzeptiert: * identisch mit $extension und kann jeden anderen Schlüssel haben case identisch mit $case,
Beispiel #3 Änderungen für die Extension Prüfung von 1.6 zu 1.7
// Beispiel für 1.6
$upload = new Zend_File_Transfer_Adapter_Http();
$upload->addValidator('Extension',
array('jpg,gif,bmp', true));
// Gleiches Beispiel für 1.7
$upload = new Zend_File_Transfer_Adapter_Http();
$upload->addValidator('Extension',
false,
array('extension1' => 'jpg,gif,bmp',
'case' => true));
Prüfung: FilesSize
Alte API der Methode:
Zend_Validate_File_FilesSize($min, $max, $bytestring)Neue API der Methode:
Zend_Validate_File_FilesSize($options)wobei $options die folgenden Schlüssel für das Array akzeptiert: min identisch mit $min, max identisch mit $max, bytestring identisch mit $bytestring
Zustätzlich wurde die Signatur der useByteString() Methode geändert. Sie kann
nur verwendet werden um zu testen ob die Prüfung ByteStrings in den erzeugten Meldungen
verwendet oder ncht. Um den Wert dieses Flags zu setzen muß die
setUseByteString() Methode verwendet werden.
Beispiel #4 Änderungen für die FilesSize Prüfung von 1.6 zu 1.7
// Beispiel für 1.6
$upload = new Zend_File_Transfer_Adapter_Http();
$upload->addValidator('FilesSize',
array(100, 10000, true));
// Gleiches Beispiel für 1.7
$upload = new Zend_File_Transfer_Adapter_Http();
$upload->addValidator('FilesSize',
false,
array('min' => 100,
'max' => 10000,
'bytestring' => true));
// Beispiel für 1.6
$upload->useByteString(true); // Flag setzen
// Gleiches Beispiel für 1.7
$upload->setUseByteSting(true); // Flag setzen
Prüfung: Hash
Alte API der Methode:
Zend_Validate_File_Hash($hash, $algorithm)Neue API der Methode:
Zend_Validate_File_Hash($options)wobei $options die folgenden Schlüssel für das Array akzeptiert: * identisch mit $hash und kann jeden anderen Schlüssel haben algorithm identisch mit $algorithm,
Beispiel #5 Änderungen für die Hash Prüfung von 1.6 zu 1.7
// Beispiel für 1.6
$upload = new Zend_File_Transfer_Adapter_Http();
$upload->addValidator('Hash',
array('12345', 'md5'));
// Gleiches Beispiel für 1.7
$upload = new Zend_File_Transfer_Adapter_Http();
$upload->addValidator('Hash',
false,
array('hash1' => '12345',
'algorithm' => 'md5'));
Prüfung: ImageSize
Alte API der Methode:
Zend_Validate_File_ImageSize($minwidth, $minheight, $maxwidth, $maxheight)Neue API der Methode:
Zend_Validate_File_FilesSize($options)wobei $options die folgenden Schlüssel für das Array akzeptiert: minwidth identisch mit $minwidth, maxwidth identisch mit $maxwidth, minheight identisch mit $minheight, maxheight identisch mit $maxheight,
Beispiel #6 Änderungen für die ImageSize Prüfung von 1.6 zu 1.7
// Beispiel für 1.6
$upload = new Zend_File_Transfer_Adapter_Http();
$upload->addValidator('ImageSize',
array(10, 10, 100, 100));
// Gleiches Beispiel für 1.7
$upload = new Zend_File_Transfer_Adapter_Http();
$upload->addValidator('ImageSize',
false,
array('minwidth' => 10,
'minheight' => 10,
'maxwidth' => 100,
'maxheight' => 100));
Prüfung: Size
Alte API der Methode:
Zend_Validate_File_Size($min, $max, $bytestring)Neue API der Methode:
Zend_Validate_File_Size($options)wobei $options die folgenden Schlüssel für das Array akzeptiert: min identisch mit $min, max identisch mit $max, bytestring identisch mit $bytestring
Beispiel #7 Änderungen für die Size Prüfung von 1.6 zu 1.7
// Beispiel für 1.6
$upload = new Zend_File_Transfer_Adapter_Http();
$upload->addValidator('Size',
array(100, 10000, true));
// Gleiches Beispiel für 1.7
$upload = new Zend_File_Transfer_Adapter_Http();
$upload->addValidator('Size',
false,
array('min' => 100,
'max' => 10000,
'bytestring' => true));
Migration von 1.6.1 zu 1.6.2 oder neuer
Änderungen bei der Verwendung von Prüfungen
Wie von Benutzern festgestellt wurde, haben die Prüfungen von Zend_File_Transfer
nicht auf die gleiche Art und Weise funktioniert wie standardmäßigen von Zend_Form.
Zend_Form erlaubt die Verwendung eines breakChainOnFailure Parameters
der die Prüfung für alle weitere Prüfer unterbricht wenn ein Prüffehler aufgetreten ist.
Deshalb wurde dieser Parameter bei allen bestehenden Prüfungen von Zend_File_Transfer
hinzugefügt.
Alte API der Methode:
addValidator($validator, $options, $files).Neue API der Methode:
addValidator($validator, $breakChainOnFailure, $options, $files).
Um also eigene Skripte auf die neue API zu migrieren, muß einfach ein false nach
der Definition der gewünschten Prüfung hinzugefügt werden.
Beispiel #8 Wie man eigene Dateiprüfungen von 1.6.1 auf 1.6.2 ändert
// Beispiel für 1.6.1
$upload = new Zend_File_Transfer_Adapter_Http();
$upload->addValidator('FilesSize', array('1B', '100kB'));
// Selbes Beispiel für 1.6.2 und neuer
// Beachte das hinzugefügte boolsche false
$upload = new Zend_File_Transfer_Adapter_Http();
$upload->addValidator('FilesSize', false, array('1B', '100kB'));
| Filter für Zend_File_Transfer |