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 :
array(host,port,errno,errmsg)
'writefailed' -
si l'écriture sur le disque échoue, ce rappel est appelé avec :
array(destfile,errmsg)
Si un proxy HTTP a été configuré
(paramètre http_proxy de la configuration PEAR_Config),
le proxy sera utilisé.
Paramètres
string
$url
l'URL à télécharger.
object
&$ui
instance PEAR_Frontend_*
string
$save_dir
dossier où le fichier sera sauvegardé
mixed
$callback
fonction/méthode à appeler pour mettre à jour le statut
object
$config
instance PEAR_Config
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().
