Zend Framework 1.7.9 Manual
|
|
L'API de Zend_File_Transfer a changé au cours du temps. Si vous avez commencé à utiliser
Zend_File_Transfer et ses sous-composants avec les versions précédentes, suivez les lignes directrices
ci-dessous pour migrer vos scripts et ainsi utiliser la nouvelle API.
Certaines remarques des utilisateurs indiquaient que les validateurs de
Zend_File_Transfer ne fonctionnaient pas correctement avec Zend_Config dû au fait
qu'ils n'utilisait pas de tableaux nommés.
De plus, tous les filtres et validateurs de Zend_File_Transfer ont été réécrits. Même si
les anciennes signatures continuent à fonctionner, elles ont été marqués comme dépréciées et émettent une
notice PHP vous informant de faire le changement.
La liste suivante vous montre les changements à réaliser pour une utilisation appropriée des paramètres.
Ancienne API : Zend_Filter_File_Rename($oldfile, $newfile, $overwrite)
Nouvelle API : Zend_Filter_File_Rename($options) où $options
accepte un tableau avec les clés suivantes : source est équivalent à
$oldfile, target est équivalent à $newfile,
overwrite est équivalent à $overwrite.
Example #1 Changer le filtre rename entre 1.6 et 1.7
// Exemple pour 1.6
$upload = new Zend_File_Transfer_Adapter_Http();
$upload->addFilter('Rename',
array('/path/to/oldfile', '/path/to/newfile', true));
// Même exemple pour 1.7
$upload = new Zend_File_Transfer_Adapter_Http();
$upload->addFilter('Rename',
array('source' => '/path/to/oldfile',
'target' => '/path/to/newfile',
'overwrite' => true));
Ancienne API : Zend_Validate_File_Count($min, $max)
Nouvelle API : Zend_Validate_File_Count($options) où $options
accepte un tableau avec les clés suivantes : min est équivalent à
$min, max est équivalent à $max.
Example #2 Changer le validateur count entre 1.6 et 1.7
// Exemple pour 1.6
$upload = new Zend_File_Transfer_Adapter_Http();
$upload->addValidator('Count',
array(2, 3));
// Même exemple pour 1.7
$upload = new Zend_File_Transfer_Adapter_Http();
$upload->addValidator('Count',
array('min' => 2,
'max' => 3));
Ancienne API : Zend_Validate_File_Extension($extension, $case)
Nouvelle API : Zend_Validate_File_Extension($options) où
$options accepte un tableau avec les clés suivantes : * est
équivalent à $extension et peut avoir tout autre clé, case est
équivalent à $case.
Example #3 Changer le validateur extension entre 1.6 et 1.7
// Exemple pour 1.6
$upload = new Zend_File_Transfer_Adapter_Http();
$upload->addValidator('Extension',
array('jpg,gif,bmp', true));
// Même exemple pour 1.7
$upload = new Zend_File_Transfer_Adapter_Http();
$upload->addValidator('Extension',
array('extension1' => 'jpg,gif,bmp',
'case' => true));
Ancienne API : Zend_Validate_File_FilesSize($min, $max, $bytestring)
Nouvelle API : Zend_Validate_File_FilesSize($options) où
$options accepte un tableau avec les clés suivantes : min est
équivalent à $min, max est équivalent à $max,
bytestring est équivalent à $bytestring.
De plus la signature de la méthode useByteString() a changé. Elle peut être seulement
utilisée pour tester si le validateur prévoie d'utiliser les chaînes lisibles ou la valeur brute dans
les messages générées. Pour paramétrer la valeur de cette option, utilisez la méthode
setUseByteString().
Example #4 Changer le validateur filessize entre 1.6 et 1.7
// Exemple pour 1.6
$upload = new Zend_File_Transfer_Adapter_Http();
$upload->addValidator('FilesSize',
array(100, 10000, true));
// Même exemple pour 1.7
$upload = new Zend_File_Transfer_Adapter_Http();
$upload->addValidator('FilesSize',
array('min' => 100,
'max' => 10000,
'bytestring' => true));
// Exemple pour 1.6
$upload->useByteString(true); // set flag
// Même exemple pour 1.7
$upload->setUseByteSting(true); // set flag
Ancienne API : Zend_Validate_File_Hash($hash, $algorithm)
Nouvelle API : Zend_Validate_File_Hash($options) où $options
accepte un tableau avec les clés suivantes : * est équivalent à
$hash et peut avoir tout autre clé, algorithm est équivalent à
$algorithm.
Example #5 Changer le validateur hash entre 1.6 et 1.7
// Exemple pour 1.6
$upload = new Zend_File_Transfer_Adapter_Http();
$upload->addValidator('Hash',
array('12345', 'md5'));
// Même exemple pour 1.7
$upload = new Zend_File_Transfer_Adapter_Http();
$upload->addValidator('Hash',
array('hash1' => '12345',
'algorithm' => 'md5'));
Ancienne API : Zend_Validate_File_ImageSize($minwidth, $minheight, $maxwidth,
$maxheight)
Nouvelle API : Zend_Validate_File_FilesSize($options) où
$options accepte un tableau avec les clés suivantes : minwidth
est équivalent à $minwidth, maxwidth est équivalent à
$maxwidth, minheight est équivalent à $minheight,
maxheight est équivalent à $maxheight.
Example #6 Changer le validateur imagesize entre 1.6 et 1.7
// Exemple pour 1.6
$upload = new Zend_File_Transfer_Adapter_Http();
$upload->addValidator('ImageSize',
array(10, 10, 100, 100));
// Même exemple pour 1.7
$upload = new Zend_File_Transfer_Adapter_Http();
$upload->addValidator('ImageSize',
array('minwidth' => 10,
'minheight' => 10,
'maxwidth' => 100,
'maxheight' => 100));
Ancienne API : Zend_Validate_File_Size($min, $max, $bytestring)
Nouvelle API : Zend_Validate_File_Size($options) où $options
accepte un tableau avec les clés suivantes : min est équivalent à
$min, max est équivalent à $max,
bytestring est équivalent à $bytestring
Example #7 Changer le validateur size entre 1.6 et 1.7
// Exemple pour 1.6
$upload = new Zend_File_Transfer_Adapter_Http();
$upload->addValidator('Size',
array(100, 10000, true));
// Même exemple pour 1.7
$upload = new Zend_File_Transfer_Adapter_Http();
$upload->addValidator('Size',
array('min' => 100,
'max' => 10000,
'bytestring' => true));
Certaines remarques des utilisateurs indiquaient que les validateurs de
Zend_File_Transfer ne fonctionnaient pas comme ceux par défaut fournis avec
Zend_Form. Zend_Form permet par exemple l'utilisation du paramètre
breakChainOnFailure qui stoppe la validation de tous les validateurs suivants dès qu'une erreur
de validation apparaît.
Nous avons donc ajouter ce paramètre à tous les validateurs existants pour
Zend_File_Transfer.
Ancienne API : addValidator($validator, $options, $files).
Nouvelle API : addValidator($validator, $breakChainOnFailure, $options,
$files).
Pour migrer vos scripts vers la nouvelle API, ajoutez simplement un a false après voir
défini le validateur souhaité.
Example #8 Changer les validateurs de fichiers de 1.6.1 vers 1.6.2
// Exemple pour 1.6.1
$upload = new Zend_File_Transfer_Adapter_Http();
$upload->addValidator('FilesSize', array('1B', '100kB'));
// Même exemple pour 1.6.2 et plus récent
// Notez l'ajout du booléen false
$upload = new Zend_File_Transfer_Adapter_Http();
$upload->addValidator('FilesSize', false, array('1B', '100kB'));
|
|
|