Welcome to the Cookbook

Pour ajouter un champ d'upload de fichier dans un formulaire, vous devez d'abord vous assurer que l'attribut enctype du formulaire est fixé à "multipart/form-data", vous devez donc commencer par une fonction de création définie comme ci-dessous.

echo $form->create('Document', array('enctype' => 'multipart/form-data') );

// ou

echo $form->create('Document', array('type' => 'file'));

1. echo $form->create('Document', array('enctype' => 'multipart/form-data') );
2. // ou
3. echo $form->create('Document', array('type' => 'file'));

Ensuite, ajoutez une des deux lignes suivantes à votre fichier de vue formulaire.

echo $form->input('Document.fichiersoumis', array('between'=>'<br />','type'=>'file'));

// ou

echo $form->file('Document.fichiersoumis');

1. echo $form->input('Document.fichiersoumis', array('between'=>'<br />','type'=>'file'));
2. // ou
3. echo $form->file('Document.fichiersoumis');

A cause des limitations liées à HTML, il n'est pas possible de définir une valeur par défaut dans les champs inputs de type 'file'. Chaque fois que le formulaire est affiché, le champ sera vide.

Dès la soumission, les champs de fichier fournissent un tableau étendu de données au script qui reçoit les données du formulaire.

Dans l'exemple ci-dessus, les valeurs du tableau de données soumis seraient organisées de la manière suivante, si CakePHP était installé sur un serveur Windows. 'tmp_name' aurait un chemin différent dans un environnement Unix.

$this->data['Document']['fichiersoumis'] = array(
    'name' => planning_conference.pdf
    'type' => application/pdf
    'tmp_name' => C:/WINDOWS/TEMP/php1EE.tmp
    'error' => 0
    'size' => 41737
);

1. $this->data['Document']['fichiersoumis'] = array(
2. 'name' => planning_conference.pdf
3. 'type' => application/pdf
4. 'tmp_name' => C:/WINDOWS/TEMP/php1EE.tmp
5. 'error' => 0
6. 'size' => 41737
7. );

Ce tableau est généré par PHP lui-même, donc pour plus de détail sur la façon dont PHP gère les données passées dans les champ de fichier, lisez la section sur l'upload de fichier du manuel PHP.