L'upload de fichiers en PHP est vraiment très facile. Nous allons voir comment faire.

1- Création du formulaire html

Tout d'abord, il faut créer notre formulaire html, avec un ou plusieurs champ(s) permettant au visiteur de sélectionner un fichier sur sa machine.

Ces champs sont des champs input de type file, vous pouvez en mettre autant que vous voulez sur la page, PHP gère l'envoi multiple depuis la version 3.0.10.

Il faut également spécifier la valeur multipart/form-data dans le type d'encodage des données du formulaire (enctype).

Exemple :

  1. <!-- Formulaire -->
  2. <!-- Attention, ne de ne pas oublier le  enctype="multipart/form-data" -->
  3. <form method="POST" action="notre_script.php" enctype="multipart/form-data">
  4. <!-- Limiter la taille des fichiers à 500Ko -->
  5. <input type="hidden" name="MAX_FILE_SIZE" value="500000" /> 
  6. <fieldset>
  7. <legend>Envoi de fichiers</legend>
  8. <!-- champs d'envoi de fichier, de type file -->
  9. <p><label for="photo">Photo :</label><input type="file" name="photo" /></p>
  10. <p><label for="photo_2">Photo 2 :</label><input type="file" name="photo_2" /></p>
  11. <!-- bouton d'envoi -->
  12. <p><input type="submit" name="envoi" value="Envoyer les fichiers" /></p>
  13. </legend>
  14. </fieldset>
  15. </form>

2- Gérer des fichiers envoyés avec PHP

Lorsque le formulaire est envoyé, les fichiers sont envoyés sur le serveur dans un répertoire temporaire. Une fois ces fichiers envoyés, le script php dans la partie action du formulaire est lancé. Une fois que le script php est terminé, les fichiers envoyés sont supprimés du répertoire temporaire. Il faut donc traiter/copier ces fichiers avant.

Récupérer les informations des fichiers envoyés

Les informations sur les fichiers envoyés sont accessibles depuis le tableau global $_FILES, contenant les informations suivantes :

ClefDescription
name Nom original du fichier, tel que sur la machine du visiteur.
type Type MIME du fichier, si le navigateur a fourni cette information. Exemple : image/gif.
size Taille, en octets, du fichier envoyé.
tmp_name Chemin du fichier temporaire sur le serveur.
error Code d'erreur associé à l'envoi du fichier (PHP > 4.2.0).

Donc par exemple $_FILES['photo']['tmp_name'] retourne le chemin du fichier temporaire sur le serveur.

Copier les fichiers

Pour copier les fichiers envoyés dans un autre répertoire rien de plus simple, il suffit d'utiliser la fonction move_uploaded_file(). Vous devez néanmoins également donner les droits d'écriture à PHP sur le répertoire dans lequel vous souhaitez copier les fichiers. Pour cela vous pouvez par exemple utiliser la fonction CHMOD de votre logiciel FTP.

Exemple d'utilisation de move_uploaded_file :

  1. <?php
  2.  
  3. if(isset($_FILES['photo']))
  4. {
  5.   $dest_dossier = '/home/damien/photos/';
  6.   // utilisez également des slashes sous windows : $dest_dossier  = 'd:/damien/photos/';
  7.   $dest_fichier = basename($_FILES['photo']['name']);
  8.   move_uploaded_file($_FILES['photo']['tmp_name'], $dest_dossier . $dest_fichier);
  9. }
  10.  
  11. ?>

NB : N'utilisez pas ce code tel quel, lisez bien le prochain chapitre du tutorial.

3- ... mais attention !

Sécurité

Dans l'exemple précédent, le visiteur peut envoyer n'importe quel type de fichier. Rien ne l'empêche d'envoyer un fichier PHP à la place d'une photo ! Et ensuite de l'éxecuter si le répertoire dans lequel vous stockez vos fichiers est accessible depuis le web. Il faut donc toujours penser à vérifier quel type de fichier l'utilisateur envoie, en acceptant que les fichiers ayant l'extension attendue. 

  1. <?php
  2. // récupère la partie de la chaine à partir du dernier .
  3. // Ex : .png
  4. $extension = strrchr($_FILES['photo']['name'], '.');
  5. // récupère la partie après le .
  6. // Ex : png
  7. $extension = substr($extension, 1);
  8. ?>

De plus, le visiteur peut aussi enregistrer le formulaire sur son ordinateur, et modifier la valeur du champ caché MAX_FILE_SIZE, pour ainsi envoyer des fichiers plus volumineux. Il est donc également préférable de vérifier la taille du fichier.

  1. <?php
  2. // récupère la taille du fichier
  3. $taille = filesize($_FILES['photo']['tmp_name']);
  4. ?>

Nom du fichier

Toujours dans l'exemple du chapitre précédent, on utilise le nom original de l'image (tel que sur la machine du visiteur) comme nom du fichier sur notre serveur. Cela peut poser des problèmes. Il est préférable de supprimer les accents, les espaces et les caractères spéciaux.

  1. <?php
  2. // enlever les accents
  3. $dest_fichier = strtr($dest_fichier, 
  4. 'ÀÁÂÃÄÅÇÈÉÊËÌÍÎÏÒÓÔÕÖÙÚÛÜÝàáâãäåçèéêëìíîïðòóôõöùúûüýÿ', 
  5. 'AAAAAACEEEEIIIIOOOOOUUUUYaaaaaaceeeeiiiioooooouuuuyy');
  6. // remplacer les caracteres autres que lettres, chiffres et point par _
  7. $dest_fichier = preg_replace('/([^.a-z0-9]+)/i', '_', $dest_fichier);
  8. ?>

4- Exemple

L'exemple du chapitre 2 donne donc :

  1. <?php
  2.  
  3. if(isset($_FILES['photo']))
  4. {
  5.   // params
  6.   unset($erreur);
  7.   $extensions_ok = array('png', 'gif', 'jpg', 'jpeg');
  8.   $taille_max = 100000;
  9.   $dest_dossier = '/home/damien/photos/';
  10.   // utilisez également des slashes sous windows : $dest_dossier  = 'd:/damien/photos/';
  11.   // vérifications
  12.   if( !in_array( substr(strrchr($_FILES['photo']['name'], '.'), 1), $extensions_ok ) )
  13.   {
  14.     $erreur = 'Veuillez sélectionner un fichier de type png, gif ou jpg !';  
  15.   }
  16.   elseif( file_exists($_FILES['photo']['tmp_name']) 
  17.           and filesize($_FILES['photo']['tmp_name']) > $taille_max)
  18.   {
  19.     $erreur = 'Votre fichier doit faire moins de 500Ko !';
  20.   }
  21.   // copie du fichier
  22.   if(!isset($erreur))
  23.   {
  24.     $dest_fichier = basename($_FILES['photo']['name']);
  25.     // formatage nom fichier
  26.     // enlever les accents
  27.     $dest_fichier = strtr($dest_fichier, 
  28.     'ÀÁÂÃÄÅÇÈÉÊËÌÍÎÏÒÓÔÕÖÙÚÛÜÝàáâãäåçèéêëìíîïðòóôõöùúûüýÿ', 
  29.     'AAAAAACEEEEIIIIOOOOOUUUUYaaaaaaceeeeiiiioooooouuuuyy');
  30.     // remplacer les caracteres autres que lettres, chiffres et point par _
  31.     $dest_fichier = preg_replace('/([^.a-z0-9]+)/i', '_', $dest_fichier);
  32.     // copie du fichier
  33.     move_uploaded_file($_FILES['photo']['tmp_name'], $dest_dossier . $dest_fichier);
  34.   }
  35. }
  36.  
  37. ?>
  38. <html>
  39. <body>
  40. <!-- Erreur ? -->
  41. <?php 
  42. if(isset($erreur)){
  43.   echo '<p>', $erreur ,'</p>';
  44. }
  45. ?>
  46. <!-- Formulaire -->
  47. <!-- Attention, ne de ne pas oublier le  enctype="multipart/form-data" -->
  48. <form method="POST" action="30.php" enctype="multipart/form-data">
  49. <!-- Limiter la taille des fichiers à 500Ko -->
  50. <input type="hidden" name="MAX_FILE_SIZE" value="500000" /> 
  51. <fieldset>
  52. <legend>Envoi de fichiers</legend>
  53. <!-- champs d'envoi de fichier, de type file -->
  54. <p><label for="photo">Photo :</label><input type="file" name="photo" /></p>
  55. <!-- bouton d'envoi -->
  56. <p><input type="submit" name="envoi" value="Envoyer les fichiers" /></p>
  57. </legend>
  58. </fieldset>
  59. </form>
  60. </body>
  61. </html>

Télécharger l'exemple

Deux autres tutoriaux, avec des exemples plus complets (comment gérer l'envoi d'images, et un autre sur l'importation de fichier CSV) seront mis en ligne prochainement.

5- Remarques complémentaires

Envoyer des fichiers volumineux

Vous avez vu tout à l'heure que l'on peut limiter la taille des fichiers envoyés avec un champ de type hidden. Mais il existe également des options de configuration de la taille maximum dans le fichier php.ini.

  • La principale option est la directive upload_max_filesize, qui permet de fixer la taille maximale d'un fichier que l'on peut envoyer (en général 2Mo par défaut).
  • Mais augmenter cette valeur peut ne pas être suffisant. Il existe également la directive post_max_size pour délimiter la taille maximum des données qui peuvent être envoyées par la méthode POST (généralement 8Mo par défaut), taille des fichiers envoyés inclue. Pensez donc à modifier les deux valeurs si vous voulez permettre l'upload de fichiers volumineux.
  • La directive memory_limit, si activée, peut également avoir une influence sur l'upload de fichier.
  • Enfin, il faudra probablement augmenter la limite du temps d'execution de vos scripts à l'aide des directives max_execution_time et max_input_time.

Seules les directives memory_limit et max_*_time sont modifiables depuis vos scripts php :

  1. <?php
  2. ini_set('memory_limit', 8000000); // en octets
  3. set_time_limit(600); // en secondes
  4. ?>

Pour modifier les deux autres options (si vous n'avez pas accès aux fichiers php.ini ou httpd.conf), vous devez utiliser un fichier .htaccess : 

php_value upload_max_filesize 5000000
php_value post_max_size 10000000

NB : Attention, pour modifier la configuration de PHP depuis un fichier .htaccess, PHP doit être installé en tant que module apache, pas en tant que CGI. Vous obtenez sinon une erreur 500.

Afficher la progression du téléchargement

Malheureusement, PHP ne permet pas d'afficher de barre de progression pendant le téléchargement. Pourquoi ? La raison est simple, le script PHP est appelé uniquement lorsque l'envoi du fichier est terminé, et ne donne pas accès aux données raw post. On ne peut donc pas controler où en est le chargement, même en utilisant du javascript.

Pas sans changement en tous cas. Il existe en effet une extension non officielle qui permet de gérer une barre de progression pendant le téléchargement. Il faut par contre appliquer un patch à PHP, et compiler l'extension. Vous ne pouvez pas le faire n'importe où (il faut pouvoir administrer le serveur), et vous devez avoir les compétences pour le faire. Le lien ci dessous n'est donc fournit qu'à titre informatif, et s'adresse aux utilisateurs avancés. A vos risques et périls.

Sinon, il existe également un projet utilisant un mix de PHP et de Perl, ne nécessitant pas d'appliquer de patch au serveur. Vous devez néanmoins pouvoir utiliser Perl sur votre serveur, bien évidemment.

6- Autres ressources