PEAR_Common::downloadHttp
Prev Next

PEAR_Common::downloadHttp

PEAR_Common::downloadHttp() – Télécharge un fichier via HTTP

Synopsis

require_once 'PEAR/common.php';

string PEAR_Common::downloadHttp ( string $url , object &$ui , string $save_dir = '.' , mixed $callback = = null )

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)
    ?>

Si un proxy HTTP a été configuré (paramètre http_proxy de la configuration PEAR_Config), le proxy sera utilisé.

Parameter

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

Return value

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().

Throws

Possible PEAR_Error values
Code erreur Valeur de l'erreur Signification Solution
"

Note

This function can not be called statically.

Prev PEAR_Common Next
PEAR_Common::buildProvidesArray PEAR Manual PEAR_Common::infoFromAny