Description

Descarga un fichero mediante HTTP. Considera el nombre del fichero sugerido en la cabecera Content-disposition: y puede ejecutar una función callback para distintos eventos. La función callback será llamada con dos parámetros: el tipo de callback, y parámetros. Los tipos de callback implementados son:

• 'setup' - llamada al principio, parámetro es un objeto UI que debería usarse para toda salida

• 'message' - el parámetro es una cadena con un mensaje informativo

• 'saveas' - puede usarse para guardarse con un nombre de fichero distinto, el parámetro es el nombre del fichero que se va a usar. Si una llamada a 'saveas' devuelve una cadena no vacía, se usar ésta como nombre del fichero. Destacar que $save_dir no se verá afectado por esto, sólo el nombre del fichero.

• 'start' - la descarga se empieza, el parámetro es el número de bytes que se esperan, o -1 si se desconocen

• 'bytesread' - el parámetro es el número de bytes leidos

• 'done' - la descarga está completa, el parámetro es el número total de bytes leidos

• 'connfailed' - si la conexión TCP falla, se llama a este callback con

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

• 'writefailed' - si la escritura a disco falla, se llama a este callback con

  <?php
array(destfile,errmsg)
?>

Sin se ha configurado un proxy HTTP (http_proxy configuración PEAR_Config), se usará éste.

Parameter

Return value

string - Devuelve la ruta completa del fichero descargado o un error PEAR en caso de fallo. Si el error se ha causado por un error de socket, el objeto error tendrá el código de error fsockopen disponible mediante getCode().

Throws

Note

This function can not be called statically.