CFFILE |
Fichier |
|---|---|
| ColdFusion (CFML) |
Syntaxe
|
<CFFILE paramètres> |
Paramètres
| Nom | Description | |
|---|---|---|
| action="upload" | Ce paramètre permet d'indiquer le type de manipulation de fichier pour cette balise. | |
| destination=valeur | Ce paramètre permet d'indiquer le chemin du répertoire où doit aller le fichier à téléverser sur le système d'exploitation. Si vous n'utilisez pas un chemin absolue (lequel commence par une barre oblique ou une lettre, un deux-points et barre oblique inversé), on peut se baser sur le résultat de la fonction GetTempDirectory pour connaitre le dossier d'origine. | |
| fileField=valeur | Ce paramètre permet d'indiquer le nom du champ de formulaire utiliser pour sélectionner le fichier. | |
| accept=valeur | Ce paramètre optionnel permet d'indiquer les formats MIME allant être accepté par cette balise. S'il y a plusieurs format reconnus, il faudra les séparer par une virgule. | |
| attributes=valeur | Ce paramètre optionnel permet d'indiquer la la liste d'attribut à fixer au fichier. | |
| mode=valeur | Ce paramètre optionnel, uniquement disponible sous Unix et Linux, permet d'indiquer la valeur octal de permission (soit l'équivalent de la commande chmod). Ainsi, la valeur 777 autorise une lecture, écriture et une exécution. | |
| nameConflict=valeur | Ce paramètre optionnel permet d'indiquer l'action à entreprendre si le nom de fichier est le même qu'un fichier dans le répertoire. Voici les valeurs reconnus : | |
| Valeur | Description | |
| Error | Cette valeur permet d'indiquer que le fichier n'est pas sauvegarder et que la page retourne une erreur. | |
| Skip | Cette valeur permet d'indiquer que le fichier n'est pas sauvegarder et que le comportement est basé sur les propriétés de fichier. | |
| Overwrite | Cette valeur permet d'indiquer que le fichier est remplacé. | |
| MakeUnique | Cette valeur permet d'indiquer qu'il faut produire un nom de fichier unique et qu'il est entreposé dans la variable d'objet «serverFile». | |
| result=variable | Ce paramètre optionnel permet d'indiquer le nom de la variable dans lequel il faut retourner le résultat. Si le paramètre n'est pas définit, cette balise utilise le préfixe «cffile». | |
Description
Cette balise permet de gérer des opérations de «Gestionnaire de fichiers» comme le téléversement (Upload). Ainsi, après que le téléversement du fichier soit terminé, il est possible d'obtenir les informations d'états en utilisant les paramètres. Pour obtenir ses paramètres, vous devez utiliser le préfixe «cffile» ou, si vous l'avez définit avec le paramètre «result», le nom que vous souhaitez utiliser. Ainsi, si vous n'avez pas spécifié le paramètre «result», vous devriez consulter la propriété «fileExisted» de la façon suivante «cffile.fileExisted».
Remarques
- ATTENTION ! Vous devez avoir définit «enctype="multipart/form-data"» dans la balise HTML de formulaire «FORM» ou la balise ColdFusion «CFFORM» pour que le téléversement fonctionne.
- Problème de téléversement d'image : Si vous avez des erreurs lors de téléchargement d'image, que vous utilisez le projet tiers comme ImageCFC et que vos spécifications de tailles sont correctes, il est possible que ce soit un format d'image trop récent causant le problème. Une simple resauvegarde avec l'application «paint» du système d'exploitation Windows corrige souvent le problème.
Voir également
Langage de programmation - ColdFusion (CFML) - Référence des balises - CFDIRECTORY
Dernière mise à jour : Vendredi, le 11 septembre 2015