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

$upload = new Zend_File_Transfer();

// Paramètre un poids de fichier de 20000 octets
$upload->addValidator('Size', false, 20000);

// Paramètre un poids de fichier de 20 octets minimum
// et de 20000 octets maximum
$upload->addValidator('Size', false, array('min' => 20, 'max' => 20000));

// Paramètre un poids de fichier de 20 octets minimum et
// de 20000 octets maximum et un nombre de fichiers en une seule étape
$upload->setValidators(array(
    'Size'  => array('min' => 20, 'max' => 20000),
    'Count' => array('min' => 1, 'max' => 3),
));

$upload = new Zend_File_Transfer();

// Paramètre un poids de fichier de 20000 octets et
// limite celui-ci à 'file2'
$upload->addValidator('Size', false, 20000, 'file2');

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

$upload = new Zend_File_Transfer();

// Paramètre un poids de fichier de 20000 octets
$upload->addValidator('Size', false, 20000)
       ->addValidator('Count', false, 2)
       ->addValidator('Filessize', false, 25000);

Et pour finir vous pouvez tout simplement vérifier le(s) fichier(s) en appelant isValid().

$upload = new Zend_File_Transfer();

// Paramètre un poids de fichier de 20000 octets
$upload->addValidator('Size', false, 20000)
       ->addValidator('Count', false, 2)
       ->addValidator('Filessize', false, 25000);

if (!$upload->isValid()) {
    print "Echec de validation";
}

Quand une validation a échouée, c'est probablement intéressant d'avoir des informations sur les problèmes rencontrés. A cette fin, vous pouvez utiliser la méthode getMessages() qui retourne tous les messages de validation sous la forme d'un tableau, getErrors() qui retourne tous les codes d'erreurs et hasErrors() qui retourne TRUE dès qu'une erreur de validation est rencontrée.

Le validateur Count vérifie le nombre de fichiers fournis. Il supporte les clés d'options suivantes :

Vous pouvez initialiser ce validateur avec une chaîne ou un entier, la valeur sera utilisée en tant que max. Mais vous pouvez aussi utiliser les méthodes setMin() et setMax() pour paramétrer ces options plus tard et getMin() et getMax() pour les récupérer.

$upload = new Zend_File_Transfer();

// Limite le nombre de fichiers à 2 maximum
$upload->addValidator('Count', false, 2);

// Limite le nombre de fichiers à 5 maximum,
// tout en obligeant au moins 1 fichier
$upload->addValidator('Count', false, array('min' =>1, 'max' => 5));

Le validateur Crc32 vérifie le contenu du fichier transféré en le hachant. Ce validateur utilise l'extension de hachage de PHP avec l'algorithme crc32. Il supporte les options suivantes :

$upload = new Zend_File_Transfer();

// Vérifie si le contenu d'un fichier uploadé correspond au hachage fourni
$upload->addValidator('Crc32', false, '3b3652f');

// Limite ce validateur à deux différents hachages
$upload->addValidator('Crc32', false, array('3b3652f', 'e612b69'));

Le validateur ExcludeExtension vérifie l'extension des fichiers fournis. Il supporte les options suivantes :

Ce validateur accepte des extensions multiples soit sous la forme d'une chaîne utilisant le caractère virgule (",") comme séparateur ou sous la forme d'un tableau. Vous pouvez aussi utiliser les méthodes setExtension(), addExtension(), et getExtension() pour paramétrer et récupérer les extensions.

Dans certains cas, il est utile vérifier aussi la casse. A cette fin le constructeur autorise un second paramètre $case qui, s'il est réglé à TRUE, validera l'extension en vérifiant aussi la casse.

$upload = new Zend_File_Transfer();

// Refuser les fichiers avec l'extension php ou exe
$upload->addValidator('ExcludeExtension', false, 'php,exe');

// Refuser les fichiers avec l'extension php ou exe en utilisant
// la notation de type tableau
$upload->addValidator('ExcludeExtension', false, array('php', 'exe'));

// Vérifier aussi la casse
$upload->addValidator('ExcludeExtension', false, array('php', 'exe', 'case' => true));

Le validateur ExcludeMimeType vérifie le type MIME des fichiers transférés. Il supporte les options suivantes :

Ce validateur accepte des types MIME multiples soit sous la forme d'une chaîne utilisant le caractère virgule (",") comme séparateur ou sous la forme d'un tableau. Vous pouvez aussi utiliser les méthodes setMimeType(), addMimeType(), et getMimeType() pour paramétrer et récupérer les types MIME.

$upload = new Zend_File_Transfer();

// Refuser le type MIME d'image gif pour tous les fichiers
$upload->addValidator('ExcludeMimeType', false, 'image/gif');

// Refuser le type MIME d'image gif et jpg pour tous les fichiers
$upload->addValidator('ExcludeMimeType', false, array('image/gif', 'image/jpeg');

// Refuser les types MIME du groupe image pour tous les fichiers
$upload->addValidator('ExcludeMimeType', false, 'image');

L'exemple ci-dessus montre qu'il est aussi possible de limiter le type MIME accepté à un groupe de type MIME. Pour refuser toutes les images utilisez simplement "image" en tant que type MIME. Ceci peut être appliqué à tous les groupes de type MIME comme "image", "audio", "video", "text" et plus encore.

Le validateur Exists l'existence des fichiers fournis. Il supporte les options suivantes :

Ce validateur accepte des extensions multiples soit sous la forme d'une chaîne utilisant le caractère virgule (",") comme séparateur ou sous la forme d'un tableau. Vous pouvez aussi utiliser les méthodes setDirectory(), addDirectory(), et getDirectory() pour paramétrer et récupérer les extensions.

$upload = new Zend_File_Transfer();

// Ajoute le dossier temporaire à vérifier
$upload->addValidator('Exists', false, '\temp');

// Ajoute deux dossiers en utilsant la notation de type tableau
$upload->addValidator('Exists',
                      false,
                      array('\home\images', '\home\uploads'));

Le validateur Extension vérifie l'=es extensions des fichiers qui ont été fournis. Il supporte les options suivantes :

Ce validateur accepte des extensions multiples soit sous la forme d'une chaîne utilisant le caractère virgule (",") comme séparateur ou sous la forme d'un tableau. Vous pouvez aussi utiliser les méthodes setExtension(), addExtension(), et getExtension() pour paramétrer et récupérer les extensions.

Dans certains cas, il est utile vérifier aussi la casse. A cette fin le constructeur autorise un second paramètre $case qui, s'il est réglé à TRUE, validera l'extension en vérifiant aussi la casse.

$upload = new Zend_File_Transfer();

// Limite les extensions à jpg et png
$upload->addValidator('Extension', false, 'jpg,png');

// Limite les extensions à jpg et png en utilisant
// la notation de type tableau
$upload->addValidator('Extension', false, array('jpg', 'png'));

// Vérifie aussi la casse
$upload->addValidator('Extension', false, array('mo', 'png', 'case' => true));
if (!$upload->isValid('C:\temp\myfile.MO')) {
    print 'Non valide à cause de MO au lieu de mo';
}

Le validateur FilesSize vérifie le poids total de tous les fichiers transférés. Il supporte les options suivantes :

Vous pouvez initialiser seulement avec une chaîne qui sera utilisée en tant que max. Mais vous pouvez aussi utiliser les méthodes setMin() et setMax() pour paramétrer ces options plus tard et getMin() et getMax() pour les récupérer.

La taille elle-même est acceptée en notation SI comme sur la plupart des systèmes d'exploitation. Au lieu de 20000 octets (NdT. : "bytes" en anglais), vous pouvez utiliser 20kB. Toutes les unités sont converties en utilisant 1024 comme valeur de base. Les unités suivantes sont acceptées : kB, MB, GB, TB, PB et EB. Comme mentionné précédemment vous devez noter que 1kB équivaut à 1024 octets.

$upload = new Zend_File_Transfer();

// Limite la taille de tous les fichiers à 40000 octets
$upload->addValidator('FilesSize', false, 40000);

// Limite la taille de tous les fichiers dans une plage de 10kB à 4MB
$upload->addValidator('FilesSize', false, array('min' => '10kB',
                                                'max' => '4MB'));

// Comme ci-dessus, mais retourne la taille de fichier brute plutôt qu'une chaîne
$upload->addValidator('FilesSize', false, array('min' => '10kB',
                                                'max' => '4MB',
                                                'bytestring' => false));

Le validateur ImageSize vérifie la taille des images. Il supporte les options suivantes :

Vous pouvez aussi utiliser les méthodes setImageMin() et setImageMax() pour régler les valeurs minimum et maximum plus tard et getMin() et getMax() pour les récupérer.

Par commodité, il existe aussi les méthodes setImageWidth et setImageHeight qui paramètrent la largeur et la hauteur minimum et maximum. Bien sûr les méthodes associées getImageWidth et getImageHeight sont aussi disponibles.

Pour désactiver la validation d'une dimension, ne paramétrez pas l'option correspondante.

$upload = new Zend_File_Transfer();

// Limite la taille de l'image à une hauteur de 100 à 200 et
// une largeur de 40 à 80 pixels
$upload->addValidator('ImageSize',
                      false,
                      array('minwidth' => 40,
                            'maxwidth' => 80,
                            'minheight' => 100,
                            'maxheight' => 200);

// Autre possibilité de réglage
$upload->setImageWidth(array('minwidth' => 20, 'maxwidth' => 200));

Le validateur IsCompressed vérifie si un fichier transféré est une archive compressée comme zip ou arc. Ce validateur est basée sur le validateur MimeType et supportent les mêmes méthodes et options. Vous pouvez limiter ce validateur à des types de compression particuliers avec les méthodes décrites ci-dessous.

$upload = new Zend_File_Transfer();

// Vérifie si un fichier uploadé est une archive compressée
$upload->addValidator('IsCompressed', false);

// Limite ce validateur aux fichiers zip seulement
$upload->addValidator('IsCompressed', false, array('application/zip'));

// Limite ce validateur aux fichiers zip mais avec la notation simplifiée
$upload->addValidator('IsCompressed', false, 'zip');

Le validateur IsImage vérifie si un fichier transféré est une image comme gif ou jpeg. Ce validateur est basée sur le validateur MimeType et supportent les mêmes méthodes et options. Vous pouvez limiter ce validateur à des types d'image particuliers avec les méthodes décrites ci-dessous.

$upload = new Zend_File_Transfer();

// Vérifie si un fichier uploadé est une image
$upload->addValidator('IsImage', false);

// Limite ce validateur aux fichiers gif seulement
$upload->addValidator('IsImage', false, array('application/gif'));

// Limite ce validateur aux fichiers jpeg mais avec la notation simplifiée
$upload->addValidator('IsImage', false, 'jpeg');

Le validateur Hash vérifie le contenu du fichier transféré en le hachant. Ce validateur utilise l'extension de hachage de PHP. Il supporte les options suivantes :

$upload = new Zend_File_Transfer();

// Vérifie si le contenu d'un fichier uploadé correspond au hachage fourni
$upload->addValidator('Hash', false, '3b3652f');

// Limite ce validateur à deux différents hachages
$upload->addValidator('Hash', false, array('3b3652f', 'e612b69'));

// Paramètre un algorithme différent pour effectuer le hachage
$upload->addValidator('Hash', false, array('315b3cd8273d44912a7', 'algorithm' => 'md5'));

Le validateur Md5 vérifie le contenu du fichier transféré en le hachant. Ce validateur utilise l'extension de hachage de PHP avec l'algorithme md5. Il supporte les options suivantes :

$upload = new Zend_File_Transfer();

// Vérifie si le contenu d'un fichier uploadé correspond au hachage fourni
$upload->addValidator('Md5', false, '3b3652f336522365223');

// Limite ce validateur à deux différents hachages
$upload->addValidator('Md5', false, array('3b3652f336522365223', 'eb3365f3365ddc65365'));

Le validateur MimeType vérifie le type MIME des fichiers transférés. Il supporte les options suivantes :

Ce validateur accepte des types MIME multiples soit sous la forme d'une chaîne utilisant le caractère virgule (",") comme séparateur ou sous la forme d'un tableau. Vous pouvez aussi utiliser les méthodes setMimeType(), addMimeType(), et getMimeType() pour paramétrer et récupérer les types MIME.

Vous pouvez aussi paramétrer le magicfile qui sera utilisé par fileinfo avec l'option magicfile. De plus il existe les méthodes setMagicFile() et getMagicFile() qui permettent de paramétrer ou récupérer plus tard le paramètre magicfile. Ces méthodes sont disponibles à partir de la version Zend Framework 1.7.1.

$upload = new Zend_File_Transfer();

// Limite le type MIME de tous les fichiers aux images gif
$upload->addValidator('MimeType', false, 'image/gif');

// Limite le type MIME de tous les fichiers aux images jpeg et gif
$upload->adValidator('MimeType', false, array('image/gif', 'image/jpeg');

// Limite le type MIME de tous les fichiers au groupe des images
$upload->addValidator('MimeType', false, 'image');

// Utilise un magicfile différent
$upload->addValidator('MimeType', false, array('image', 'magicfile' => '/path/to/magicfile.mgx'));

L'exemple ci-dessus montre qu'il est aussi possible de limiter le type MIME accepté à un groupe de type MIME. Pour autoriser toutes les images utilisez simplement "image" en tant que type MIME. Ceci peut être appliqué à tous les groupes de type MIME comme "image", "audio", "video", "text" et plus encore.

Le validateur NotExists l'existence des fichiers fournis. Il supporte les options suivantes :

Ce validateur accepte des extensions multiples soit sous la forme d'une chaîne utilisant le caractère virgule (",") comme séparateur ou sous la forme d'un tableau. Vous pouvez aussi utiliser les méthodes setDirectory(), addDirectory(), et getDirectory() pour paramétrer et récupérer les extensions.

$upload = new Zend_File_Transfer();

// Ajoute le dossier temporaire à vérifier
$upload->addValidator('NotExists', false, '\temp');

// Ajoute deux dossiers en utilisant la notation de type tableau
$upload->addValidator('NotExists',
                      false,
                      array('\home\images',
                            '\home\uploads'));

Le validateur Sha1 vérifie le contenu du fichier transféré en le hachant. Ce validateur utilise l'extension de hachage de PHP avec l'algorithme sha1. Il supporte les options suivantes :

$upload = new Zend_File_Transfer();

// Vérifie si le contenu d'un fichier uploadé correspond au hachage fourni
$upload->addValidator('Sha1', false, '3b3652f336522365223');

// Limite ce validateur à deux différents hachages
$upload->addValidator('Sha1', false, array('3b3652f336522365223', 'eb3365f3365ddc65365'));

Le validateur Size vérifie le poids d'un fichier unique. Il supporte les options suivantes :

Vous pouvez initialiser seulement avec une chaîne qui sera utilisée en tant que max. Mais vous pouvez aussi utiliser les méthodes setMin() et setMax() pour paramétrer ces options plus tard et getMin() et getMax() pour les récupérer.

Quand seule une chaîne est fournie, elle est utilisée en tant que max. Mais vous pouvez aussi utiliser les méthodes setMin() et setMax() pour paramétrer ces options plus tard et getMin() et getMax() pour les récupérer.

La taille elle-même est acceptée en notation SI comme sur la plupart des systèmes d'exploitation. Au lieu de 20000 octets, vous pouvez utiliser 20kB. Toutes les unités sont converties en utilisant 1024 comme valeur de base. Les unités suivantes sont acceptées : kB, MB, GB, TB, PB et EB. Comme mentionné précédemment vous devez noter que 1kB équivaut à 1024 octets.

$upload = new Zend_File_Transfer();

// Limite la taille d'un fichier à 40000 octets
$upload->addValidator('Size', false, 40000);

// Limite la taille du fichier 'uploadfile' dans une plage de 10kB à 4MB
// Additionally returns the plain number in case of an error instead of a userfriendly one
$upload->addValidator('Size', false, array('min' => '10kB',
                                           'max' => '4MB',
                                           'bytestring' => false));

Le validateur WordCount vérifie le nombre de mots à l'intérieur des fichiers fournis. Il supporte les options suivantes :

Si vous initialisez ce validateur avec une chaîne ou un entier, la valeur sera utilisée en tant que max. Mais vous pouvez aussi utiliser les méthodes setMin() et setMax() pour paramétrer ces options plus tard et getMin() et getMax() pour les récupérer.

$upload = new Zend_File_Transfer();

// Limite le nombre maximum de mots dans les fichiers à 2000
$upload->addValidator('WordCount', false, 2000);

// Limite le nombre de mots dans les fichiers entre un minimum de 1000
// et un maximum de 5000 mots
$upload->addValidator('WordCount', false, array('min' => 1000, 'max' => 5000));