'setup' called at the very beginning, parameter is a UI object
that should be used for all output
'message' the parameter is a string with an informational message
'saveas' may be used to save with a different file name, the
parameter is the filename that is about to be used.
If a 'saveas' callback returns a non-empty string,
that file name will be used as the filename instead.
Note that $save_dir will not be affected by this, only
the basename of the file.
'start' download is starting, parameter is number of bytes
that are expected, or -1 if unknown
'bytesread' parameter is the number of bytes read so far
'done' download is complete, parameter is the total number
of bytes read
'connfailed' if the TCP/SSL connection fails, this callback is called
with array(host,port,errno,errmsg)
'writefailed' if writing to disk fails, this callback is called
with array(destfile,errmsg)
If an HTTP proxy has been configured (http_proxy PEAR_Config
setting), the proxy will be used.
public downloadHttp ( string $url, object &$ui, string $save_dir = '.', mixed $callback = null, false | string | array $lastmodified = null, false | array $accept = false, false | string $channel = false ) : string | array | ||
$url | string | the URL to download |
$ui | object | PEAR_Frontend_* instance |
$save_dir | string | directory to save file in |
$callback | mixed | function/method to call for status updates |
$lastmodified | false | string | array | header values to check against for caching use false to return the header values from this download |
$accept | false | array | Accept headers to send |
$channel | false | string | Channel to use for retrieving authentication |
return | string | array | Returns the full path of the downloaded file or a PEAR error on failure. If the error is caused by socket-related errors, the error object will have the fsockopen error code available through getCode(). If caching is requested, then return the header values. |