L'utilisation des filtres est assez simple. Il existe de multiples méthodes pour ajouter et manipuler les filtres.

$upload = new Zend_File_Transfer();

// Paramètre un dossier de destination
$upload->addFilter('Rename', 'C:\image\uploads');

// Paramètre un nouveau dossier de destination
// et surcharge pour les fichiers existants
$upload->addFilter('Rename', array('target' => 'C:\picture\uploads', 'overwrite' => true));

$upload = new Zend_File_Transfer();

// Paramètre un nouveau dossier de destination et
// le limite seulement à "file2"
$upload->addFilter('Rename', 'C:\image\uploads', 'file2');

Généralement vous devriez simplement utiliser la méthode addFilters(), qui peut être appelée plusieurs fois.

$upload = new Zend_File_Transfer();

// Renommer différemment chacun des fichiers
$upload->addFilter('Rename', 'file1', 'C:\picture\newjpg')
       ->addFilter('Rename', 'file2', 'C:\picture\newgif');

Le filtre Decrypt permet de décrypter un fichier crypté.

Ce filtre se sert de Zend_Filter_Decrypt. Il supporte les extensions PHP Mcrypt et OpenSSL. Reportez vous à la section associée pour voir les détails des possibilités d'options pour le décryptage et connaître les options supportées.

Ce filtre supporte une option additionnelle qui peut être utilisée pour sauvegarder le fichier décrypté avec un autre nom de fichier. Spécifiez l'option filename pour changer le nom de fichier dans lequel le fichier décrypté sera stocké. Si vous supprimez cette option le fichier décrypté écrasera le fichier chiffré original.

$upload = new Zend_File_Transfer_Adapter_Http();

// Adds a filter to decrypt the uploaded encrypted file
// with mcrypt and the key mykey
$upload->addFilter('Decrypt',
    array('adapter' => 'mcrypt', 'key' => 'mykey'));

$upload = new Zend_File_Transfer_Adapter_Http();

// Adds a filter to decrypt the uploaded encrypted file
// with openssl and the provided keys
$upload->addFilter('Decrypt',
    array('adapter' => 'openssl',
          'private' => '/path/to/privatekey.pem',
          'envelope' => '/path/to/envelopekey.pem'));

Le filtre Encrypt permet de crypter un fichier.

Ce filtre se sert de Zend_Filter_Encrypt. Il supporte les extensions PHP Mcrypt et OpenSSL. Reportez vous à la section associée pour voir les détails des possibilités d'options pour le chiffrement et connaître les options supportées.

Ce filtre supporte une option additionnelle qui peut être utilisée pour sauvegarder le fichier chiffré avec un autre nom de fichier. Spécifiez l'option filename pour changer le nom de fichier dans lequel le fichier chiffré sera stocké. Si vous supprimez cette option le fichier chiffré écrasera le fichier original.

$upload = new Zend_File_Transfer_Adapter_Http();

// Adds a filter to encrypt the uploaded file
// with mcrypt and the key mykey
$upload->addFilter('Encrypt',
    array('adapter' => 'mcrypt', 'key' => 'mykey'));

$upload = new Zend_File_Transfer_Adapter_Http();

// Adds a filter to encrypt the uploaded file
// with openssl and the provided keys
$upload->addFilter('Encrypt',
    array('adapter' => 'openssl',
          'public' => '/path/to/publickey.pem'));

Le filtre LowerCase vous permet de mettre en minuscule le contenu d'un fichier. Vous devriez utiliser ce filtre seulement sur les fichiers texte.

Lors de l'initialisation vous pouvez fournir qui sera utilisée en tant qu'encodage. Ou vous pouvez utiliser la méthode setEncoding() pour le paramétrer plus tard.

$upload = new Zend_File_Transfer_Adapter_Http();
$upload->addValidator('MimeType', 'text');

// Ajoute un filtre pour mettre en minuscule les fichiers texte uploadés
$upload->addFilter('LowerCase');

// Ajoute un filtre pour mettre en minuscule seulement le fichier uploadé "uploadfile1"
$upload->addFilter('LowerCase', null, 'uploadfile1');

// Ajoute un filtre pour mettre en minuscule avec un encodage ISO-8859-1
$upload->addFilter('LowerCase', 'ISO-8859-1');

Le filtre Rename vous permet de changer le dossier de destination du fichier uploadé, de changer le nom de fichier et aussi d'écraser des fichiers existants. Il supporte les options suivantes :

De plus vous pouvez utiliser la méthode setFile() pour paramétrer des fichiers, ce qui effacera ceux précédemment paramétrés, addFile() pour ajouter un nouveau fichier à ceux déjà présent, et getFile() pour récupérer les fichiers actuellement paramétrés. Pour simplifier les choses, ce filtre accepte de multiples notations et ces méthodes et constructeur comprennent les mêmes notations.

$upload = new Zend_File_Transfer_Adapter_Http();

// Paramètre un nouveau dossier pour tous les fichiers
$upload->addFilter('Rename', 'C:\mypics\new');

// Paramètre un nouveau dossier seulement pour uploadfile1
$upload->addFilter('Rename', 'C:\mypics\newgifs', 'uploadfile1');

Vous pouvez utiliser différentes notations. Ci-dessous vous trouverez une table fournissant la description et le but des notations supportées. Notez que quand vous utilisez l'"Adapter" ou le "Form Element", vous ne pourrez pas utiliser toutes les notations décrites.

Le filtre UpperCase vous permet de mettre en minuscule le contenu d'un fichier. Vous devriez utiliser ce filtre seulement sur les fichiers texte.

Lors de l'initialisation vous pouvez fournir qui sera utilisée en tant qu'encodage. Ou vous pouvez utiliser la méthode setEncoding() pour le paramétrer plus tard.

$upload = new Zend_File_Transfer_Adapter_Http();
$upload->addValidator('MimeType', 'text');

// Ajoute un filtre pour mettre en majuscule les fichiers textes uploadés
$upload->addFilter('UpperCase');

// Ajoute un filtre pour mettre en majuscule seulement le fichier uploadé "uploadfile1"
$upload->addFilter('UpperCase', null, 'uploadfile1');

// Ajoute un filtre pour mettre en majuscule avec un encodage ISO-8859-1
$upload->addFilter('UpperCase', 'ISO-8859-1');