Zend_File_Transfer est construit pour supporter différents adaptateurs et différentes directions. Il est conçu pour permettre l'upload, le téléchargement et même l'envoi bidirectionnel (upload avec un adaptateur et télécharge avec un autre adaptateur en même temps) de fichiers.

Zend_File_Transfer et ses adaptateurs supportent plusieurs options. Vous pouvez paramétrer toutes les options soit en les fournissant au constructeur, ou en utilisant setOptions($options). getOptions() retournera les options actuellement paramétrées. Ci-dessous, vous trouverez la liste des options supportées :

Zend_File_Transfer possède plusieurs méthodes qui permettent de vérifier suivant différentes considérations. Ceci est particulièrement utile quand vous devez travailler avec des fichiers qui ont été uploadés.

$upload = new Zend_File_Transfer();

// Retourne toutes les informations connues sur le fichier
$files = $upload->getFileInfo();

foreach ($files as $file => $info) {
    // Fichier uploadé ?
    if (!$upload->isUploaded($file)) {
        print "Pourquoi n'avez-vous pas uploadé ce fichier ?";
        continue;
    }

    // Les validateurs sont-ils OK ?
    if (!$upload->isValid($file)) {
        print "Désolé mais $file ne correspond à ce que nous attendons";
        continue;
    }
}

$upload->receive();

Zend_File_Transfer peut fournir de multiples informations complémentaires sur les fichiers. Les méthodes suivantes sont disponibles :

getFileName() accepte le nom d'un élément entant que premier paramètre. Si aucun n'est fourni, tous les fichiers connus seront retournées sous la forme d'un tableau. Si le fichier est un "multifile", vous le récupérerez aussi sous la forme d'un tableau. S'il n'y a qu'un seul fichier alors une chaîne sera retournée.

Par défaut les noms de fichier sont retournés avec leur chemin d'accès complet. Si vous souhaitez seulement le nom de fichier sans le chemin, vous pouvez paramétrer le second paramètre $path à FALSE ce qui tronquera le chemin.

$upload = new Zend_File_Transfer();
$upload->receive();

// Retourne le nom de fichier pour tous les fichiers
$names = $upload->getFileName();

// Retourne le nom de fichier de l'élément de formulaire "foo"
$names = $upload->getFileName('foo');

getFileSize() retourne par défaut la taille réelle d'un fichier en notation SI ce qui signifie que vous récupérerez 2kB au lieu de 2048. Si vous voulez la taille brute, utilisez l'option useByteString à FALSE.

$upload = new Zend_File_Transfer();
$upload->receive();

// Retourne les tailles de tous les fichiers sous la forme
// d'un tableau si plus d'un fichier a été uploadé
$size = $upload->getFileSize();

// Bascule de la notation SI vers une taille brute
$upload->setOptions(array('useByteString' => false));
$size = $upload->getFileSize();

getHash() accepte le nom de l'algorithme de hachage en tant que premier paramètre. Pour avoir une liste des algorithmes connus, regardez la méthode hash_algos de PHP. Si vous ne fournissez aucun algorithme, celui par défaut sera crc32.

$upload = new Zend_File_Transfer();
$upload->receive();

// Retourne le hachage de fichier pour tous les fichiers sous la forme
// d'un tableau si plusieurs fichiers sont fournis
$hash = $upload->getHash('md5');

// Retourne le hachage de l'élément de formulaire "foo"
$names = $upload->getHash('crc32', 'foo');

getMimeType() retourne le type MIME d'un fichier. Si plus d'un fichier a été uploadé, elle retourne un tableau, sinon c'est une chaîne.

$upload = new Zend_File_Transfer();
$upload->receive();

$mime = $upload->getMimeType();

// Retourne le type MIME pour l'élément de formulaire "foo"
$names = $upload->getMimeType('foo');

Zend_File_Transfer can give you the actual state of a fileupload in progress. To use this feature you need either the APC extension which is provided with most default PHP installations, or the uploadprogress extension. Both extensions are detected and used automatically. To be able to get the progress you need to meet some prerequisites.

First, you need to have either APC or uploadprogress to be enabled. Note that you can disable this feature of APC within your php.ini.

Second, you need to have the proper hidden fields added in the form which sends the files. When you use Zend_Form_Element_File this hidden fields are automatically added by Zend_Form.

When the above two points are provided then you are able to get the actual progress of the file upload by using the getProgress method. Actually there are 2 official ways to handle this.

$adapter = new Zend_ProgressBar_Adapter_Console();
$upload  = Zend_File_Transfer_Adapter_Http::getProgress($adapter);

$upload = null;
while (!$upload['done']) {
    $upload = Zend_File_Transfer_Adapter_Http:getProgress($upload);
}

$upload  = Zend_File_Transfer_Adapter_Http::getProgress();

while (!$upload['done']) {
    $upload = Zend_File_Transfer_Adapter_Http:getProgress($upload);
    print "\nActual progress:".$upload['message'];
    // do whatever you need
}