Programmer's Reference Guide
| Zend_File |
Zend_File_Transfer
Zend_File_Transfer permet aux développeurs de contrôler l'upload de fichiers mais aussi le
téléchargement. Il vous permet d'utiliser les validateurs incorporés pour le traitement de fichier et même la
possibilité de changer les fichiers avec des filtres. Zend_File_Transfer fonctionne avec des
adaptateurs ce qui vous permet d'utiliser la même API pour différents protocoles de transfert HTTP, FTP, WEBDAV et
plus encore.
Note: Limitation
L'implémentation actuelle deZend_File_Transferembarquée en version 1.6.0 est limitée aux uploads de type HTTP Post. Le téléchargement de fichiers et les autres adaptateurs seront ajoutés dans les prochaines versions. Les méthodes non implémentées pour le moment lèveront une exception. Donc réellement vous devriez directement utiliser une instance deZend_File_Transfer_Adapter_Http. Ceci changera dans le futur, dès qu'il existera des adaptateurs disponibles.
L'utilisation de Zend_File_Transfer est assez simple. Il consiste en deux parties. Le formulaire
HTTP qui réalise l'upload, et la gestion des fichiers uploadés avec Zend_File_Transfer. Regardez
l'exemple suivant :
Exemple #1 Formulaire simple d'upload de fichier
Cet exemple illustre un upload de fichier basique avec Zend_File_Transfer. La première partie
est le formulaire. Dans notre exemple, il n'y a qu'un seul fichier que nous souhaitons uploadé.
<form enctype="multipart/form-data" action="/file/upload" method="POST">
<input type="hidden" name="MAX_FILE_SIZE" value="100000" />
Choose a file to upload: <input name="uploadedfile" type="file" /><br />
<input type="submit" value="Upload File" />
</form>
Notez que vous devriez utiliser Zend_Form_Element_File par simplicité plutôt que de créer le HTML manuellement.
L'étape suivante est de créer le récepteur de l'upload. Dans notre exemple le récepteur est
"/file/upload". Donc nous créons le contrôleur file avec l'action
upload.
$adapter = new Zend_File_Transfer_Adapter_Http();
$adapter->setDestination('C:\temp');
if (!$adapter->receive()) {
$messages = $adapter->getMessages();
echo implode("\n", $messages);
}
Comme vous le voyez, l'utilisation la plus simple est de définir une destination avec la méthode
setDestination et d'appeler la méthode receive(). S'il apparaît des erreurs au cours
de l'upload, alors vous les récupérerez grâce à une exception qui sera retournée.
Note: Attention
Maintenez à l'esprit qu'il s'agit de l'utilisation la plus simple. Vous ne devez jamais utiliser cet exemple en environnement de production car il causerait de graves problèmes de sécurité. Vous devez toujours utiliser des validateurs pour accroître la sécurité.
| Zend_File |