PEAR_Common::downloadHttp()

Description

Télécharge un fichier via HTTP. Le nom du fichier est placé dans l'en-tête Content-disposition: header et une fonction de rappel peut être exécutée pour différents évènements. La fonction de rappel est appelée avec deux paramètres : le type de rappel et des paramètres. Les types de rappel implémentés sont :

• 'setup' - appeler au tout début, le paramètre est un objet UI qui peut être utilisé pour tous les affichages.

• 'message' - le paramètre est une chaîne de caractères avec un message informel

• 'saveas' - peut être utilisé pour sauvegarder le fichier sous un nom différent, le paramètre est le nom du fichier qui sera utilisé. Si un rappel 'saveas' retourne une chaîne vide, alors le nom du fichier sera utilisé comme nom de fichier à la place. Notez que $save_dir ne sera pas affecté par celà, uniquement le nom du fichier.

• 'start' - le téléchargement a commencé, le paramètre est le nombre d'octets attendus ou -1 s'il n'est pas connu.

• 'bytesread' - le paramètre est le nombre d'octets lus jusqu'ici.

• 'done' - le téléchargement est terminé, le paramètre est le nombre total d'octets lus.

• 'connfailed' - if la connexion TCP échoue, ce rappel est appelé avec :

  <?php array(host,port,errno,errmsg) ?>

• 'writefailed' - si l'écriture sur le disque échoue, ce rappel est appelé avec :

  <?php array(destfile,errmsg) ?>

Paramètres

Valeur retournée

string - Retourne le chemin complet du fichier téléchargé ou une erreur PEAR en cas d'échec. Si l'erreur est du à un problème de socket, l'objet représentant l'erreur aura le code erreur fsockopen disponible dans getCode().

Valeurs renvoyées

Note

Cette fonction ne peut pas être appelée de façon statique.