IdentifiantMot de passe
Loading...
Mot de passe oublié ?Je m'inscris ! (gratuit)

Les formulaires et PHP5

Date de publication : 30 juillet 2006 , Date de mise à jour : 11 septembre 2006


III. Mise en pratique
III-A. Uniquement du texte : application/x-www-form-urlencoded
Le contrôle de saisie de texte court : <input type="text" />
Le contrôle caché : <input type="hidden" />
Le contrôle de choix alternatifs : <input type="radio" />
Le contrôle de choix multiples : <input type="checkbox" />
Le contrôle de saisie de texte long : <textarea></textarea>
Le contrôle de choix alternatifs ou multiples : <select></select>
III-B. Du texte + des fichiers : multipart/form-data
Les contrôles classiques
Le contrôle de choix de fichier : <input type="file" />
Les fonctions PHP


III. Mise en pratique

Il faut toujours garder à l'esprit qu'un formulaire contient des informations envoyées par l'internaute. Il n'est pas possible de se fier à ce qu'envoie un internaute, car il peut manipuler les formulaires comme bon lui semble. L'aspect sécurité est donc fondamental.
La meilleure pratique de sécurité est d'inclure le minimum possible de choses dans chaque formulaire. Si l'utilisateur a déjà renseigné une information, il est préférable d'utiliser une base de données ou des sessions pour la conserver durant sa navigation, plutôt que d'utiliser un champ de type hidden dans le formulaire (car cela donnerait à l'internaute l'occasion de modifier cette information, ce qui peut ne pas être prévu par votre application).
De plus, il convient de filtrer les variables envoyées au moyen d'un formulaire, de manière à vérifier qu'elles contiennent effectivement ce à quoi nous nous attendons. Il vous faut déterminer votre propre politique de filtrage pour chaque variable transmise par formulaire.


III-A. Uniquement du texte : application/x-www-form-urlencoded

Voici le plus courant (à tort ?) des encodages de formulaires. Il correspond à la valeur par défaut de la propriété enctype, qu'il n'est donc pas nécessaire de spécifier. Attention à ne pas envoyer autre chose que du texte au format ASCII avec cet entype.
Ces deux lignes sont équivalentes :
<form action="form.php" enctype="application/x-www-form-urlencoded">
<form action="form.php">
idea Il est possible de donner une valeur par défaut à un contrôle input à l'aide de sa propriété value="". Attention, les contrôles textarea et select fonctionnent différemment.

Le contrôle de saisie de texte court : <input type="text" />

La balise input type="text" a eté vue dans la première partie de ce tutoriel. Elle permet à l'internaute de saisir une petite quantité de texte (généralement quelques dizaines de caractères), en une seule ligne.
Reprenons l'un des premiers exemples de ce tutoriel afin de mieux organiser notre code PHP.
Prévoir les noms de variables PHP dans le formulaire
  1. <?php 
  2.  
  3. if(!empty($_POST)) 
  4. { 
  5.     // 
  6.     // Debug 
  7.     // 
  8.     echo '<pre>'; 
  9.     print_r($_POST); 
  10.     echo '</pre>'; 
  11. } 
  12.  
  13. ?> 
  14.  
  15.  
  16. <form method="post" action="<?php echo basename(__FILE__); ?>"> 
  17.     <fieldset> 
  18.         <legend>Informations personnelles</legend> 
  19.         <label>Prénom : <input type="text" name="personal[first_name]" /></label><br /> 
  20.         <label>Nom : <input type="text" name="personal[last_name]" /></label><br /> 
  21.     </fieldset> 
  22.     <fieldset> 
  23.         <legend>Informations virtuelles</legend> 
  24.         <label>Pseudonyme : <input type="text" name="virtual[nickname]" /></label><br /> 
  25.         <label>Site Web : <input type="text" name="virtual[website]" /></label><br /> 
  26.         <label>Messagerie instantanée : <input type="text" name="virtual[instant_messenger]" /></label><br /> 
  27.     </fieldset><br /> 
  28.  
  29.     <input type="submit" value="Envoyer" /> 
  30.     <input type="reset" value="Rétablir" /> 
  31. </form> 
info J'ai organisé les noms des contrôles selon la structure du formulaire. Les crochets [ ] dans le name="" permettent de définir un nom d'index pour le tableau associatif PHP. Ici, personal[first_name] signifie que la variable PHP correspondante est $_POST['personal']['first_name'].
idea J'utilise systématiquement <?php echo basename(__FILE__); ?> dans la propriété form action="" car cela me permet de donner le nom que je souhaite à mon script sans devoir me préoccuper de tout mettre à jour.

Le contrôle caché : <input type="hidden" />

Ce champ est à utiliser avec précaution. Il donne une impression de sécurité car il n'est pas visiblement présent dans la page. Cependant, un utilisateur averti saura en tirer parti s'il est mal utilisé. Il est donc fondamental de ne l'introduire que dans des situations où il aura un impact minimal et contrôlé.

Un bon exemple est un formulaire pour envoyer un commentaire sur un blog. Imaginons que l'utilisateur ait suivi un lien le conduisant à notre formulaire, qui lui permet d'entrer le titre de son message (je ne mets pas de contenu afin de simplifier l'exemple). De manière à savoir dans quel billet le commentaire sera enregistré, il est possible d'utiliser un contrôle hidden. L'utilisateur n'aurait aucun intérêt à modifier la valeur de ce champ puisque son message n'apparaîtrait pas où il le souhaite et puisque cela ne pourrait rien lui apporter.
Le contrôle hidden permet ainsi de stocker l'identifiant (de préférence numérique) du billet de destination.
Exemple prévu pour un blog
  1. <?php 
  2.  
  3. if(!empty($_POST)) 
  4. { 
  5.     // 
  6.     // Debug 
  7.     // 
  8.     echo '<pre>'; 
  9.     print_r($_POST); 
  10.     echo '</pre><br />'; 
  11.      
  12.     // 
  13.     // Récupération normale des informations 
  14.     // 
  15.     echo '<b>Titre</b> : '.$_POST['title'].'<br />'; 
  16.     echo '<b>Dans le billet numéro</b> : '.$_POST['entry_id']; 
  17.     echo '<br />'; 
  18. } 
  19.  
  20. ?> 
  21.  
  22.  
  23. <form method="post" action="<?php echo basename(__FILE__); ?>"> 
  24.     <label>Titre : <input type="text" name="title" /></label><br /> 
  25.     <input type="hidden" name="entry_id" value="3" /><br /> 
  26.  
  27.     <input type="submit" value="Envoyer" /> 
  28.     <input type="reset" value="Rétablir" /> 
  29. </form> 

Le contrôle de choix alternatifs : <input type="radio" />

Cet élément permet de répondre à une question ne pouvant avoir qu'une seule réponse parmi une liste précise de propositions. Il s'agit souvent d'un choix booléen (vrai ou faux) ou tout du moins ayant un nombre fixe (et peu élevé) de réponses possibles. C'est à mon avis le plus adapté pour répondre à cette question très fréquente : "Acceptez-vous les conditions d'utilisation de nos services (EULA) ? Oui/Non".
Pour l'utiliser, il faut répéter la propriété name="" en modifiant value="". Les boutons radio fonctionnent par groupe. Le navigateur Web sélectionne l'un ou l'autre des éléments du groupe, jamais plusieurs à la fois. L'emplacement dans le formulaire n'a aucune importance mais il est préférable de regrouper les boutons radio pour des questions d'ergonomie.
Boutons radio avec deux questions
  1. <?php 
  2.  
  3. if(!empty($_POST)) 
  4. { 
  5.     // 
  6.     // Debug 
  7.     // 
  8.     echo '<pre>'; 
  9.     print_r($_POST); 
  10.     echo '</pre>'; 
  11. } 
  12.  
  13. ?> 
  14.  
  15.  
  16. <form method="post" action="<?php echo basename(__FILE__); ?>"> 
  17.     Civilité :<br /> 
  18.     <label> 
  19.         <input type="radio" name="civilite" value="Mr" checked="checked" /> 
  20.         Mr &nbsp;&nbsp;&nbsp; 
  21.     </label> 
  22.     <label> 
  23.         <input type="radio" name="civilite" value="Mme" /> 
  24.         Mme &nbsp;&nbsp;&nbsp; 
  25.     </label> 
  26.     <label> 
  27.         <input type="radio" name="civilite" value="Mlle" /> 
  28.         Mlle 
  29.     </label><br /> 
  30.     <br /> 
  31.  
  32.     Sexe :<br /> 
  33.     <label> 
  34.         <input type="radio" name="sexe" value="masculin" checked="checked" /> 
  35.         masculin &nbsp;&nbsp;&nbsp; 
  36.     </label> 
  37.     <label> 
  38.         <input type="radio" name="sexe" value="féminin" /> 
  39.         féminin<br /> 
  40.     </label><br /><br /> 
  41.  
  42.     <input type="submit" value="Envoyer" /> 
  43.     <input type="reset" value="Rétablir" /> 
  44. </form> 

Le contrôle de choix multiples : <input type="checkbox" />

Ce contrôle permet de donner plusieurs réponses à une question donnée. Typiquement : "Quels sujets vous intéressent ?".
J'ai expliqué plus haut qu'il est possible d'utiliser les crochets [ ] dans le nom du contrôle pour que PHP le traite comme un tableau de valeurs. Nous allons nous en servir ici pour regrouper les checkboxes afin de les traiter plus facilement à l'aide de la structure foreach.
Cases de sélection pour deux questions
  1. <?php 
  2.  
  3. if(!empty($_POST)) 
  4. { 
  5.     // 
  6.     // Debug 
  7.     // 
  8.     echo '<pre>'; 
  9.     print_r($_POST); 
  10.     echo '</pre>'; 
  11.  
  12.     // 
  13.     // Récupération normale des informations 
  14.     // 
  15.     echo '<b>Sujets :</b><ul>'; 
  16.     foreach($_POST['subjects'] as $subject) 
  17.     { 
  18.         echo '<li>'.$subject.'</li>'; 
  19.     } 
  20.     echo '</ul>'; 
  21.  
  22.     echo '<b>Utilisations :</b><ul>'; 
  23.     foreach($_POST['uses'] as $use) 
  24.     { 
  25.         echo '<li>'.$use.'</li>'; 
  26.     } 
  27.     echo '</ul><br />'; 
  28. } 
  29.  
  30. ?> 
  31.  
  32.  
  33. <form method="post" action="<?php echo basename(__FILE__); ?>"> 
  34.     Quels sujets vous intéressent ?<br /> 
  35.     <label> 
  36.         <input type="checkbox" name="subjects[]" value="Technologie" checked="checked" /> 
  37.         Technologie &nbsp;&nbsp;&nbsp; 
  38.     </label> 
  39.     <label> 
  40.         <input type="checkbox" name="subjects[]" value="Développement" /> 
  41.         Développement &nbsp;&nbsp;&nbsp; 
  42.     </label> 
  43.     <label> 
  44.         <input type="checkbox" name="subjects[]" value="Recherche" /> 
  45.         Recherche 
  46.     </label><br /> 
  47.     <br /> 
  48.  
  49.     Comment utilisez-vous votre ordinateur ?<br /> 
  50.     <label> 
  51.         <input type="checkbox" name="uses[]" value="Internet" checked="checked" /> 
  52.         Internet &nbsp;&nbsp;&nbsp; 
  53.     </label> 
  54.     <label> 
  55.         <input type="checkbox" name="uses[]" value="Développement" /> 
  56.         Développement &nbsp;&nbsp;&nbsp; 
  57.     </label> 
  58.     <label> 
  59.         <input type="checkbox" name="uses[]" value="Jeu" /> 
  60.         Jeu 
  61.     </label><br /><br /> 
  62.  
  63.     <input type="submit" value="Envoyer" /> 
  64.     <input type="reset" value="Rétablir" /> 
  65. </form> 

Le contrôle de saisie de texte long : <textarea></textarea>

La balise textarea permet de saisir une grande quantité de texte, éventuellement sur plusieurs lignes. Des barres de défilement sont ajoutées automatiquement par le navigateur lorsqu'elles sont nécessaires.
Exemple prévu pour un forum
  1. <?php 
  2.  
  3. if(!empty($_POST)) 
  4. { 
  5.     // 
  6.     // Debug 
  7.     // 
  8.     echo '<pre>'; 
  9.     print_r($_POST); 
  10.     echo '</pre><br />'; 
  11.      
  12.     // 
  13.     // Récupération normale des informations 
  14.     // 
  15.     echo '<b>Titre</b> : '.$_POST['title'].'<br />'; 
  16.     echo '<b>Message</b> : '.nl2br($_POST['message']).'<br />'; 
  17.     echo '<br />'; 
  18. } 
  19.  
  20. ?> 
  21.  
  22.  
  23. <form method="post" action="<?php echo basename(__FILE__); ?>"> 
  24.     <label>Titre : <input type="text" name="title" /></label><br /> 
  25.     <label>Message : <br /> 
  26.     <textarea name="message" cols="20" rows="7"></textarea></label><br /><br /> 
  27.  
  28.     <input type="submit" value="Envoyer" /> 
  29.     <input type="reset" value="Rétablir" /> 
  30. </form> 
info Ici, print_r() et la balise pre se chargent de toute la mise en page. En situation réelle, les passages à la ligne saisis dans le textarea ne sont pas visibles dans le navigateur. Il faut utiliser la fonction nl2br() pour cela.
warning Il faut coller la balise ouvrante <textarea> à la balise fermante </textarea> si l'on ne souhaite pas avoir quoi que ce soit dans la case, lors du chargement de la page. À l'inverse, si l'on veut avoir une valeur par défaut, alors c'est à cet endroit qu'il faut la mettre.
Essayez le code suivant :
<textarea></textarea>

<textarea> </textarea>

<textarea>

</textarea>

<textarea>Texte par défaut</textarea>

Le contrôle de choix alternatifs ou multiples : <select></select>

Ce contrôle est similaire aux boutons radio ou aux checkboxes, selon son utilisation. Il permet de répondre à une question par une ou plusieurs réponses.
Il est préférable de choisir select si le nombre d'options est dynamique, car il regroupe toutes les réponses possibles dans une case de taille fixe. Si le nombre d'options vient à changer, la structure visuelle de la page n'est pas nécessairement modifiée dans le navigateur (contrairement aux boutons radio).
Réponse à deux questions avec 'select'
  1. <?php 
  2.  
  3. if(!empty($_POST)) 
  4. { 
  5.     // 
  6.     // Debug 
  7.     // 
  8.     echo '<pre>'; 
  9.     print_r($_POST); 
  10.     echo '</pre><br />'; 
  11. } 
  12.  
  13. ?> 
  14.  
  15.  
  16. <form method="post" action="<?php echo basename(__FILE__); ?>"> 
  17.     <label> 
  18.         Quel est votre sport favori ?<br /> 
  19.         <select name="sport"> 
  20.             <option value="badminton">badminton</option> 
  21.             <option value="basketball">basketball</option> 
  22.             <option value="équitation">équitation</option> 
  23.             <option value="football">football</option> 
  24.             <option value="handball">handball</option> 
  25.             <option value="natation">natation</option> 
  26.             <option value="tennis">tennis</option> 
  27.             <option value="tir à l arc">tir à l arc</option> 
  28.             <option value="voile">voile</option> 
  29.         </select> 
  30.     </label><br /><br /> 
  31.  
  32.     <label> 
  33.         Quelle est votre couleur préférée ?<br /> 
  34.         <select name="color"> 
  35.             <option value="bleu">bleu</option> 
  36.             <option value="jaune">jaune</option> 
  37.             <option value="marron">marron</option> 
  38.             <option value="orange">orange</option> 
  39.             <option value="rouge">rouge</option> 
  40.             <option value="vert">vert</option> 
  41.             <option value="violet">violet</option> 
  42.         </select> 
  43.     </label><br /><br /> 
  44.  
  45.     <input type="submit" value="Envoyer" /> 
  46.     <input type="reset" value="Rétablir" /> 
  47. </form> 
Si ce formulaire utilisait des boutons radio plutôt qu'un select, la mise en page deviendrait rapidement difficile à organiser.

Il est possible de spécifier l'attribut size pour donner un nombre de lignes fixe au contrôle select, afin de ne pas obtenir une boîte déroulante.
Réponse à deux questions avec un 'select' de taille fixe
  1. <?php 
  2.  
  3. if(!empty($_POST)) 
  4. { 
  5.     // 
  6.     // Debug 
  7.     // 
  8.     echo '<pre>'; 
  9.     print_r($_POST); 
  10.     echo '</pre><br />'; 
  11. } 
  12.  
  13. ?> 
  14.  
  15.  
  16. <form method="post" action="<?php echo basename(__FILE__); ?>"> 
  17.     <label> 
  18.         Quel est votre sport favori ?<br /> 
  19.         <select name="sport" size="5"> 
  20.             <option value="badminton">badminton</option> 
  21.             <option value="basketball">basketball</option> 
  22.             <option value="équitation">équitation</option> 
  23.             <option value="football">football</option> 
  24.             <option value="handball">handball</option> 
  25.             <option value="natation">natation</option> 
  26.             <option value="tennis">tennis</option> 
  27.             <option value="tir à l arc">tir à l arc</option> 
  28.             <option value="voile">voile</option> 
  29.         </select> 
  30.     </label><br /><br /> 
  31.  
  32.     <label> 
  33.         Quelle est votre couleur préférée ?<br /> 
  34.         <select name="color" size="5"> 
  35.             <option value="bleu">bleu</option> 
  36.             <option value="jaune">jaune</option> 
  37.             <option value="marron">marron</option> 
  38.             <option value="orange">orange</option> 
  39.             <option value="rouge">rouge</option> 
  40.             <option value="vert">vert</option> 
  41.             <option value="violet">violet</option> 
  42.         </select> 
  43.     </label><br /><br /> 
  44.  
  45.     <input type="submit" value="Envoyer" /> 
  46.     <input type="reset" value="Rétablir" /> 
  47. </form> 

Il est également possible de spécifier l'attribut multiple afin de permettre à l'internaute de sélectionner plusieurs choix. Si l'attribut size est absent, le contrôle prend toute la place (verticale) dont il a besoin. Il faut utiliser les crochets [ ] pour permettre à PHP de récupérer toutes les réponses.
L'attribut 'multiple' rend très utile le contrôle 'reset'
  1. <?php 
  2.  
  3. if(!empty($_POST)) 
  4. { 
  5.     // 
  6.     // Debug 
  7.     // 
  8.     echo '<pre>'; 
  9.     print_r($_POST); 
  10.     echo '</pre><br />'; 
  11. } 
  12.  
  13. ?> 
  14.  
  15.  
  16. <form method="post" action="<?php echo basename(__FILE__); ?>"> 
  17.     <label> 
  18.         Quels sont vos sports favoris ?<br /> 
  19.         <select name="sports[]" multiple="multiple"> 
  20.             <option value="badminton" selected="selected">badminton</option> 
  21.             <option value="basketball">basketball</option> 
  22.             <option value="équitation">équitation</option> 
  23.             <option value="football">football</option> 
  24.             <option value="handball">handball</option> 
  25.             <option value="natation">natation</option> 
  26.             <option value="tennis">tennis</option> 
  27.             <option value="tir à l arc">tir à l arc</option> 
  28.             <option value="voile" selected="selected">voile</option> 
  29.         </select> 
  30.     </label><br /><br /> 
  31.  
  32.     <label> 
  33.         Quelles sont vos couleurs préférées ?<br /> 
  34.         <select name="colors[]" size="5" multiple="multiple"> 
  35.             <option value="bleu">bleu</option> 
  36.             <option value="jaune">jaune</option> 
  37.             <option value="marron">marron</option> 
  38.             <option value="orange">orange</option> 
  39.             <option value="rouge" selected="selected">rouge</option> 
  40.             <option value="vert">vert</option> 
  41.             <option value="violet" selected="selected">violet</option> 
  42.         </select> 
  43.     </label><br /><br /> 
  44.  
  45.     <input type="submit" value="Envoyer" /> 
  46.     <input type="reset" value="Rétablir" /> 
  47. </form> 
info Un contrôle select ne peut avoir plusieurs options pré sélectionnées que s'il dispose de l'attribut multiple.
Les menus déroulants peuvent devenir très longs, ce qui a tendance à noyer l'internaute dans trop d'informations. Un moyen de pallier ce problème est d'utiliser l'élément optgroup pour grouper les options.
Groupement des réponses par thème
  1. <?php 
  2.  
  3. if(!empty($_POST)) 
  4. { 
  5.     // 
  6.     // Debug 
  7.     // 
  8.     echo '<pre>'; 
  9.     print_r($_POST); 
  10.     echo '</pre><br />'; 
  11. } 
  12.  
  13. ?> 
  14.  
  15.  
  16. <form method="post" action="<?php echo basename(__FILE__); ?>"> 
  17.     <label> 
  18.         Quel est votre sport favori ? 
  19.         <select name="sport"> 
  20.             <optgroup label="Sports aquatiques"> 
  21.                 <option value="natation">natation</option> 
  22.                 <option value="voile">voile</option> 
  23.             </optgroup> 
  24.             <optgroup label="Sports d'équipe"> 
  25.                 <option value="badminton">badminton</option> 
  26.                 <option value="basketball">basketball</option> 
  27.                 <option value="football">football</option> 
  28.                 <option value="handball">handball</option> 
  29.                 <option value="tennis">tennis</option> 
  30.             </optgroup> 
  31.             <optgroup label="Sports de plein air"> 
  32.                 <option value="équitation">équitation</option> 
  33.                 <option value="tir à l arc">tir à l arc</option> 
  34.             </optgroup> 
  35.         </select> 
  36.     </label><br /> 
  37.  
  38.     <label> 
  39.         Quelle est votre couleur préférée ? 
  40.         <select name="color"> 
  41.             <optgroup label="Primaires"> 
  42.                 <option value="bleu">bleu</option> 
  43.                 <option value="jaune">jaune</option> 
  44.                 <option value="rouge">rouge</option> 
  45.             </optgroup> 
  46.             <optgroup label="Mélanges"> 
  47.                 <option value="vert">vert</option> 
  48.                 <option value="violet">violet</option> 
  49.                 <option value="orange">orange</option> 
  50.                 <option value="marron">marron</option> 
  51.             </optgroup> 
  52.         </select> 
  53.     </label><br /><br /> 
  54.  
  55.     <input type="submit" value="Envoyer" /> 
  56.     <input type="reset" value="Rétablir" /> 
  57. </form> 
Groupement par thème, réponses multiples et pré sélection
  1. <?php 
  2.  
  3. if(!empty($_POST)) 
  4. { 
  5.     // 
  6.     // Debug 
  7.     // 
  8.     echo '<pre>'; 
  9.     print_r($_POST); 
  10.     echo '</pre><br />'; 
  11. } 
  12.  
  13. ?> 
  14.  
  15.  
  16. <form method="post" action="<?php echo basename(__FILE__); ?>"> 
  17.     <label> 
  18.         Quels sont vos sports favoris ?<br /> 
  19.         <select name="sports[]" size="10" multiple="multiple"> 
  20.             <optgroup label="Sports aquatiques"> 
  21.                 <option value="natation">natation</option> 
  22.                 <option value="voile" selected="selected">voile</option> 
  23.             </optgroup> 
  24.             <optgroup label="Sports d'équipe"> 
  25.                 <option value="badminton" selected="selected">badminton</option> 
  26.                 <option value="basketball">basketball</option> 
  27.                 <option value="football">football</option> 
  28.                 <option value="handball">handball</option> 
  29.                 <option value="tennis">tennis</option> 
  30.             </optgroup> 
  31.             <optgroup label="Sports de plein air"> 
  32.                 <option value="équitation">équitation</option> 
  33.                 <option value="tir à l arc">tir à l arc</option> 
  34.             </optgroup> 
  35.         </select> 
  36.     </label><br /><br /> 
  37.  
  38.     <label> 
  39.         Quelles sont vos couleurs préférées ?<br /> 
  40.         <select name="colors[]" size="7" multiple="multiple"> 
  41.             <optgroup label="Primaires"> 
  42.                 <option value="bleu">bleu</option> 
  43.                 <option value="jaune">jaune</option> 
  44.                 <option value="rouge" selected="selected">rouge</option> 
  45.             </optgroup> 
  46.             <optgroup label="Mélanges"> 
  47.                 <option value="vert">vert</option> 
  48.                 <option value="violet" selected="selected">violet</option> 
  49.                 <option value="orange">orange</option> 
  50.                 <option value="marron">marron</option> 
  51.             </optgroup> 
  52.         </select> 
  53.     </label><br /><br /> 
  54.  
  55.     <input type="submit" value="Envoyer" /> 
  56.     <input type="reset" value="Rétablir" /> 
  57. </form> 

III-B. Du texte + des fichiers : multipart/form-data

Cet enctype doit être utilisé pour tous les formulaires ne contenant pas uniquement du texte au format ASCII, ce qui le rend de plus en plus populaire en cette période de développement de l'UTF-8.


Les contrôles classiques

La gestion des contrôles déjà vus ci-dessus (input, textarea et select) ne change pas, je ne vais donc rien répéter. La seule différence est dans la gestion du contrôle file (qui ne devrait pas être utilisé avec un enctype différent de "multipart/form-data".


Le contrôle de choix de fichier : <input type="file" />

Ce contrôle permet à l'internaute de choisir un fichier de son ordinateur afin de l'envoyer au serveur Web grâce au formulaire. Le transfert est effectué au moyen du protocole HTTP (pas de FTP ici), ce qui signifie que rien n'est réellement prévu pour envoyer des fichiers (contrairement au FTP). Ne vous étonnez pas si vous avez du mal à transférer des fichiers de plusieurs Mio...

Le script PHP peut faire ce qu'il souhaite avec ce fichier : il est enregistré dans un dossier temporaire du serveur Web, ce qui signifie que sa durée de vie est limitée. Le serveur Web le supprimera certainement au bout d'un moment.
Il est ainsi possible d'utiliser le fichier comme pièce jointe d'un e-mail, de l'envoyer dans la base de données, de l'enregistrer sur le disque du serveur, etc.
Envoi de fichier par formulaire
  1. <?php 
  2.  
  3. // 
  4. // Provient de la documentation PHP de la fonction ini_get() 
  5. // 
  6. function return_bytes($val) 
  7. { 
  8.    $val = trim($val); 
  9.    $last = strtolower($val[strlen($val)-1]); 
  10.    switch($last) 
  11.    { 
  12.        // The 'G' modifier is available since PHP 5.1.0 
  13.        case 'g': 
  14.            $val *= 1024; 
  15.        case 'm': 
  16.            $val *= 1024; 
  17.        case 'k': 
  18.            $val *= 1024; 
  19.    } 
  20.  
  21.    return $val; 
  22. } 
  23.  
  24. define('MAX_FILE_SIZE', return_bytes(ini_get('post_max_size'))); 
  25.  
  26. if(!empty($_FILES)) 
  27. { 
  28.     // 
  29.     // Debug 
  30.     // 
  31.     echo '<pre>'; 
  32.     print_r($_FILES); 
  33.     echo '</pre>'; 
  34. } 
  35.  
  36. ?> 
  37.  
  38.  
  39. <form method="post" action="<?php echo basename(__FILE__); ?>" enctype="multipart/form-data"> 
  40.     <input type="hidden" name="MAX_FILE_SIZE" value="<?php echo MAX_FILE_SIZE; ?>" /> 
  41.     <label>Fichier joint : <input type="file" name="file" /></label><br /><br /> 
  42.  
  43.     <input type="submit" value="Envoyer" /> 
  44.     <input type="reset" value="Rétablir" /> 
  45. </form> 
L'exécution de ce code nous montre que PHP récupère des informations sur chaque fichier envoyé de cette manière.

info Le champ MAX_FILE_SIZE sert uniquement d'indication au navigateur. Il n'est pas possible de faire confiance à $_POST['MAX_FILE_SIZE'] puisque, ainsi que je l'ai évoqué plus haut, l'internaute peut modifier cette information à sa convenance.
Son utilité est uniquement d'ordre pratique pour l'internaute. Ce champ indique au navigateur la taille maximale (en octets) que le serveur peut supporter avec un tel transfert. Cela lui permet d'éviter d'initier le transfert si la taille est dépassée, ainsi l'internaute ne perd pas son temps.
idea Utiliser ini_get('post_max_size') permet de toujours inclure dans le formulaire la valeur réelle de MAX_FILE_SIZE en l'extrayant directement du fichier php.ini, plutôt que de mettre une valeur arbitraire. Il nous faut appeler return_bytes() pour avoir l'équivalent numérique en octets. Attention, cette fonction n'est pas native de PHP : il faut la définir dans votre script d'une manière ou d'une autre.
Voici le contenu du tableau $_FILES :
  • name : C'est le nom du fichier d'origine ; ce nom peut ne pas convenir au système de fichiers de notre serveur Web
  • type : Le type MIME du fichier tel que le navigateur le précise (attention, ce n'est ni le serveur Web ni PHP qui s'en occupent) ; cette information peut être falsifiée
  • tmp_name : Le nom attribué par le serveur Web lors de la réception du fichier dans le dossier temporaire
  • error : S'il n'y a pas eu d'erreur, ce champ vaut "0" (zéro) ; c'est le serveur Web qui détermine cette valeur
  • size : La taille du fichier, en octets ; cette information est fournie par le navigateur et peut être fausse
warning Un développeur soucieux de la sécurité de son application ne devrait se fier qu'à $_FILES['tmp_name'], $_FILES['error'] et dans une moindre mesure $_FILES['name']. Il est préférable de déterminer le reste par le script PHP, puisqu'un utilisateur averti est en mesure de falsifier les informations $_FILES['name'], $_FILES['type'] et $_FILES['size'].
Gestion des erreurs
  1. <?php 
  2.  
  3. // 
  4. // Fonction trouvée dans la documentation de la fonction ini_get() 
  5. // 
  6. function return_bytes($val) 
  7. { 
  8.    $val = trim($val); 
  9.    $last = strtolower($val[strlen($val)-1]); 
  10.    switch($last) 
  11.    { 
  12.        // The 'G' modifier is available since PHP 5.1.0 
  13.        case 'g': 
  14.            $val *= 1024; 
  15.        case 'm': 
  16.            $val *= 1024; 
  17.        case 'k': 
  18.            $val *= 1024; 
  19.    } 
  20.  
  21.    return $val; 
  22. } 
  23.  
  24. define('MAX_FILE_SIZE', return_bytes(ini_get('post_max_size'))); 
  25.  
  26. if(!empty($_FILES)) 
  27. { 
  28.     // 
  29.     // Debug 
  30.     // 
  31.     echo '<pre>'; 
  32.     print_r($_FILES); 
  33.     echo '</pre>'; 
  34.  
  35.     // 
  36.     // Récupération normale des informations 
  37.     // 
  38.     if(is_uploaded_file($_FILES['attached_file']['tmp_name'])) 
  39.     { 
  40.         $name     = $_FILES['attached_file']['name']; 
  41.         $tmp_name = $_FILES['attached_file']['tmp_name']; 
  42.         $error    = $_FILES['attached_file']['error']; 
  43.  
  44.         // 
  45.         // Type mime du fichier 
  46.         // 
  47.         if(function_exists('mime_content_type')) 
  48.         { 
  49.             // Notre système nous permet de déterminer le type réel 
  50.             $type = mime_content_type($tmp_name); 
  51.         } 
  52.         else 
  53.         { 
  54.             // Nous sommes contraints à faire confiance à l'internaute 
  55.             $type = $_FILES['attached_file']['type']; 
  56.         } 
  57.  
  58.         // 
  59.         // Gestion des erreurs éventuelles 
  60.         // 
  61.         switch($error) 
  62.         { 
  63.             case UPLOAD_ERR_OK: 
  64.                 $error_string = 'Fichier correctement reçu'; 
  65.             break; 
  66.  
  67.             case UPLOAD_ERR_INI_SIZE: 
  68.                 $error_string = 'Fichier trop volumineux (php.ini)'; 
  69.             break; 
  70.  
  71.             case UPLOAD_ERR_FORM_SIZE: 
  72.                 $error_string = 'Fichier trop volumineux (MAX_FILE_SIZE)'; 
  73.             break; 
  74.  
  75.             case UPLOAD_ERR_PARTIAL: 
  76.                 $error_string = 'Fichier partiellement envoyé'; 
  77.             break; 
  78.  
  79.             case UPLOAD_ERR_NO_FILE: 
  80.                 $error_string = 'Fichier non envoyé'; 
  81.             break; 
  82.  
  83.             case UPLOAD_ERR_NO_TMP_DIR: 
  84.                 $error_string = 'Pas de répertoire temporaire'; 
  85.             break; 
  86.  
  87.             case UPLOAD_ERR_CANT_WRITE: 
  88.                 $error_string = "Impossible d'écrire sur le disque"; 
  89.             break; 
  90.         } 
  91.  
  92.  
  93.         // 
  94.         // Debug 
  95.         // 
  96.         echo '<pre>'; 
  97.         print_r( 
  98.             array 
  99.             ( 
  100.                 'name'  => $name, 
  101.                 'type'  => $type, 
  102.                 'error' => $error, 
  103.                 'size'  => filesize($tmp_name), 
  104.                 'tmp_name'     => $tmp_name, 
  105.                 'error_string' => $error_string 
  106.             ) 
  107.         ); 
  108.         echo '</pre>'; 
  109.     } 
  110. } 
  111.  
  112. ?> 
  113.  
  114.  
  115. <form method="post" action="<?php echo basename(__FILE__); ?>" enctype="multipart/form-data"> 
  116.     <input type="hidden" name="MAX_FILE_SIZE" value="<?php echo MAX_FILE_SIZE; ?>" /> 
  117.     <label>Fichier joint : <input type="file" name="attached_file" /></label><br /><br /> 
  118.  
  119.     <input type="submit" value="Envoyer" /> 
  120.     <input type="reset" value="Rétablir" /> 
  121. </form> 
warning Comme le précise sa page de la documentation, la fonction mime_content_type() est obsolète. Je l'utilise ici à des fins de simplification du code.
Si nous souhaitons envoyer plusieurs fichiers à la fois, il faut à nouveau utiliser les crochets [ ] dans l'attribut name mais, cette fois, le comportement est légèrement différent. En effet, ce n'est pas $_FILES['variable'] qui est transformé en tableau mais chacun de ses indexes.
Envoyer plusieurs fichiers à la fois
  1. <?php 
  2.  
  3. // 
  4. // Fonction trouvée dans la documentation de la fonction ini_get() 
  5. // 
  6. function return_bytes($val) 
  7. { 
  8.    $val = trim($val); 
  9.    $last = strtolower($val[strlen($val)-1]); 
  10.    switch($last) 
  11.    { 
  12.        // The 'G' modifier is available since PHP 5.1.0 
  13.        case 'g': 
  14.            $val *= 1024; 
  15.        case 'm': 
  16.            $val *= 1024; 
  17.        case 'k': 
  18.            $val *= 1024; 
  19.    } 
  20.  
  21.    return $val; 
  22. } 
  23.  
  24. define('MAX_FILE_SIZE', return_bytes(ini_get('post_max_size'))); 
  25.  
  26. if(!empty($_FILES)) 
  27. { 
  28.     // 
  29.     // Debug 
  30.     // 
  31.     echo '<pre>'; 
  32.     print_r($_FILES); 
  33.     echo '</pre>'; 
  34. } 
  35.  
  36. ?> 
  37.  
  38.  
  39. <form method="post" action="<?php echo basename(__FILE__); ?>" enctype="multipart/form-data"> 
  40.     <input type="hidden" name="MAX_FILE_SIZE" value="<?php echo MAX_FILE_SIZE; ?>" /> 
  41.     <label>Fichier joint : <input type="file" name="files[]" /></label><br /> 
  42.     <label>Fichier joint : <input type="file" name="files[]" /></label><br /> 
  43.     <label>Fichier joint : <input type="file" name="files[]" /></label><br /><br /> 
  44.  
  45.     <input type="submit" value="Envoyer" /> 
  46.     <input type="reset" value="Rétablir" /> 
  47. </form> 
Nous pouvons remarquer que le tableau $_FILES['files'] se décompose ainsi (pour trois fichiers) :
  • ['name'][0]
  • ['name'][1]
  • ['name'][2]
  • ['type'][0]
  • ['type'][1]
  • ['type'][2]
  • ['tmp_name'][0]
  • ['tmp_name'][1]
  • ['tmp_name'][2]
  • ['error'][0]
  • ['error'][1]
  • ['error'][2]
  • ['size'][0]
  • ['size'][1]
  • ['size'][2]

Il n'est pas pratique d'utiliser foreach avec une telle structure. Voyons comment gérer les erreurs de plusieurs fichiers avec une structure for.
Gestion des erreurs :
  1. <?php 
  2.  
  3. // 
  4. // Fonction trouvée dans la documentation de la fonction ini_get() 
  5. // 
  6. function return_bytes($val) 
  7. { 
  8.    $val = trim($val); 
  9.    $last = strtolower($val[strlen($val)-1]); 
  10.    switch($last) 
  11.    { 
  12.        // The 'G' modifier is available since PHP 5.1.0 
  13.        case 'g': 
  14.            $val *= 1024; 
  15.        case 'm': 
  16.            $val *= 1024; 
  17.        case 'k': 
  18.            $val *= 1024; 
  19.    } 
  20.  
  21.    return $val; 
  22. } 
  23.  
  24. define('MAX_FILE_SIZE', return_bytes(ini_get('post_max_size'))); 
  25.  
  26. if(!empty($_FILES)) 
  27. { 
  28.     // 
  29.     // Debug 
  30.     // 
  31.     echo '<pre>'; 
  32.     print_r($_FILES); 
  33.     echo '</pre>'; 
  34.  
  35.     // 
  36.     // Récupération normale des informations 
  37.     // 
  38.     $nb_of_files = count($_FILES['attached_files']['tmp_name']); 
  39.     echo '<ul>'; 
  40.     for($i = 0; $i< $nb_of_files; ++$i) 
  41.     { 
  42.         if(is_uploaded_file($_FILES['attached_files']['tmp_name'][$i])) 
  43.         { 
  44.             $name     = $_FILES['attached_files']['name'][$i]; 
  45.             $tmp_name = $_FILES['attached_files']['tmp_name'][$i]; 
  46.             $error    = $_FILES['attached_files']['error'][$i]; 
  47.  
  48.             // 
  49.             // Type mime du fichier 
  50.             // 
  51.             if(function_exists('mime_content_type')) 
  52.             { 
  53.                 // Notre système nous permet de déterminer le type réel 
  54.                 $type = mime_content_type($tmp_name); 
  55.             } 
  56.             else 
  57.             { 
  58.                 // Nous sommes contraints à faire confiance à l'internaute 
  59.                 $type = $_FILES['attached_files']['type'][$i]; 
  60.             } 
  61.  
  62.             // 
  63.             // Gestion des erreurs éventuelles 
  64.             // 
  65.             switch($error) 
  66.             { 
  67.                 case UPLOAD_ERR_OK: 
  68.                     echo 'Fichier correctement reçu'; 
  69.                 break; 
  70.  
  71.                 case UPLOAD_ERR_INI_SIZE: 
  72.                     echo 'Fichier trop volumineux (php.ini)'; 
  73.                 break; 
  74.  
  75.                 case UPLOAD_ERR_FORM_SIZE: 
  76.                     echo 'Fichier trop volumineux (MAX_FILE_SIZE)'; 
  77.                 break; 
  78.  
  79.                 case UPLOAD_ERR_PARTIAL: 
  80.                     echo 'Fichier partiellement envoyé'; 
  81.                 break; 
  82.  
  83.                 case UPLOAD_ERR_NO_FILE: 
  84.                     echo 'Fichier non envoyé'; 
  85.                 break; 
  86.  
  87.                 case UPLOAD_ERR_NO_TMP_DIR: 
  88.                     echo 'Pas de répertoire temporaire'; 
  89.                 break; 
  90.  
  91.                 case UPLOAD_ERR_CANT_WRITE: 
  92.                     echo "Impossible d'écrire sur le disque"; 
  93.                 break; 
  94.             } 
  95.  
  96.  
  97.             // 
  98.             // Debug 
  99.             // 
  100.             echo '<li>'; 
  101.             echo '<b>Fichier '.$i.'</b> :'; 
  102.             echo '<pre>'; 
  103.             print_r( 
  104.                 array 
  105.                 ( 
  106.                     'name'  => $name, 
  107.                     'type'  => $type, 
  108.                     'error' => $error, 
  109.                     'size'  => filesize($tmp_name), 
  110.                     'tmp_name'     => $tmp_name, 
  111.                     'error_string' => $error_string 
  112.                 ) 
  113.             ); 
  114.             echo '</pre>'; 
  115.             echo '</li>'; 
  116.         } 
  117.     } 
  118.     echo '</ul>'; 
  119. } 
  120.  
  121. ?> 
  122.  
  123.  
  124. <form method="post" action="<?php echo basename(__FILE__); ?>" enctype="multipart/form-data"> 
  125.     <input type="hidden" name="MAX_FILE_SIZE" value="<?php echo MAX_FILE_SIZE; ?>" /> 
  126.     <label>Fichier joint : <input type="file" name="attached_files[]" /></label><br /> 
  127.     <label>Fichier joint : <input type="file" name="attached_files[]" /></label><br /> 
  128.     <label>Fichier joint : <input type="file" name="attached_files[]" /></label><br /><br /> 
  129.  
  130.     <input type="submit" value="Envoyer" /> 
  131.     <input type="reset" value="Rétablir" /> 
  132. </form> 
warning Comme le précise sa page de la documentation, la fonction mime_content_type() est obsolète. Je l'utilise ici à des fins de simplification du code.

Les fonctions PHP

PHP met à disposition un certain nombre de fonctions
  • is_uploaded_file() : permet de savoir si le fichier est bien un fichier envoyé par HTTP ; il est possible que le dossier temporaire utilisé par le serveur Web soit utilisé par d'autres applications, d'où l'utilité de cette fonction
  • move_uploaded_file() : déplace un fichier du répertoire temporaire vers un répertoire à préciser (attention aux doits en écriture - chmod 777) ; si cette fonction n'est pas utilisée à la suite d'un transfert, le serveur Web détruit le fichier temporaire
Enregistrer sur le disque du serveur
  1. <?php 
  2.  
  3. // 
  4. // Fonction trouvée dans la documentation de la fonction ini_get() 
  5. // 
  6. function return_bytes($val) 
  7. { 
  8.    $val = trim($val); 
  9.    $last = strtolower($val[strlen($val)-1]); 
  10.    switch($last) 
  11.    { 
  12.        // The 'G' modifier is available since PHP 5.1.0 
  13.        case 'g': 
  14.            $val *= 1024; 
  15.        case 'm': 
  16.            $val *= 1024; 
  17.        case 'k': 
  18.            $val *= 1024; 
  19.    } 
  20.  
  21.    return $val; 
  22. } 
  23.  
  24. define('MAX_FILE_SIZE', return_bytes(ini_get('post_max_size'))); 
  25. define('UPLOAD_DIRECTORY', './uploads/'); 
  26.  
  27. if(!empty($_FILES)) 
  28. { 
  29.     // 
  30.     // Debug 
  31.     // 
  32.     echo '<b>$_FILES</b> :<pre>'; 
  33.     print_r($_FILES); 
  34.     echo '</pre>'; 
  35.  
  36.     // 
  37.     // Récupération normale des informations 
  38.     // 
  39.     $nb_of_files = count($_FILES['attached_files']['tmp_name']); 
  40.     echo '<ul>'; 
  41.     for($i = 0; $i< $nb_of_files; ++$i) 
  42.     { 
  43.         if(is_uploaded_file($_FILES['attached_files']['tmp_name'][$i])) 
  44.         { 
  45.             $name     = $_FILES['attached_files']['name'][$i]; 
  46.             $tmp_name = $_FILES['attached_files']['tmp_name'][$i]; 
  47.             $error    = $_FILES['attached_files']['error'][$i]; 
  48.             $clean_name = strtolower(basename($name)); 
  49.             $clean_name = preg_replace('/[^a-z0-9.-]/', '-', $clean_name); 
  50.  
  51.             // 
  52.             // Type mime du fichier 
  53.             // 
  54.             if(function_exists('mime_content_type')) 
  55.             { 
  56.                 // Notre système nous permet de déterminer le type réel 
  57.                 $type = mime_content_type($tmp_name); 
  58.             } 
  59.             else 
  60.             { 
  61.                 // Nous sommes contraints à faire confiance à l'internaute 
  62.                 $type = $_FILES['attached_files']['type'][$i]; 
  63.             } 
  64.  
  65.             // 
  66.             // Déplacement hors du répertoire temporaire 
  67.             // 
  68.             if(!move_uploaded_file($tmp_name, UPLOAD_DIRECTORY.$clean_name)) 
  69.             { 
  70.                 $error_string = "Le fichier <b>n'a pas</b> été déplacé correctement"; 
  71.             } 
  72.             else 
  73.             { 
  74.                 $error_string = 'Le fichier a été déplacé correctement'; 
  75.             } 
  76.  
  77.  
  78.             // 
  79.             // Debug 
  80.             // 
  81.             echo '<li>'; 
  82.             echo '<b>Fichier '.$i.'</b> :'; 
  83.             echo '<pre>'; 
  84.             print_r( 
  85.                 array 
  86.                 ( 
  87.                     'name'  => $name, 
  88.                     'type'  => $type, 
  89.                     'error' => $error, 
  90.                     'size'  => filesize($tmp_name), 
  91.                     'tmp_name'     => $tmp_name, 
  92.                     'clean_name'   => $clean_name, 
  93.                     'error_string' => $error_string 
  94.                 ) 
  95.             ); 
  96.             echo '</pre>'; 
  97.             echo '</li>'; 
  98.         } 
  99.     } 
  100.     echo '</ul>'; 
  101. } 
  102.  
  103. ?> 
  104.  
  105.  
  106. <form method="post" action="<?php echo basename(__FILE__); ?>" enctype="multipart/form-data"> 
  107.     <input type="hidden" name="MAX_FILE_SIZE" value="<?php echo MAX_FILE_SIZE; ?>" /> 
  108.     <label>Fichier joint : <input type="file" name="attached_files[]" /></label><br /> 
  109.     <label>Fichier joint : <input type="file" name="attached_files[]" /></label><br /> 
  110.     <label>Fichier joint : <input type="file" name="attached_files[]" /></label><br /><br /> 
  111.  
  112.     <input type="submit" value="Envoyer" /> 
  113.     <input type="reset" value="Rétablir" /> 
  114. </form> 
warning Comme le précise sa page de la documentation, la fonction mime_content_type() est obsolète. Je l'utilise ici à des fins de simplification du code.
 

Valid XHTML 1.1!Valid CSS!

Copyright © 2006 Guillaume Rossolini. Aucune reproduction, même partielle, ne peut être faite de ce site ni de l'ensemble de son contenu : textes, documents, images, etc. sans l'autorisation expresse de l'auteur. Sinon vous encourez selon la loi jusqu'à trois ans de prison et jusqu'à 300 000 € de dommages et intérêts.