Helping ordinary people create extraordinary websites!


PEAR Manual
PrevNext

PEAR_REST::downloadHttp()

PEAR_REST::downloadHttp()  --  Efficiently Download a file through HTTP. Returns downloaded file as a string in-memory This is best used for small files

Synopsis

require_once '/REST.php';

string|array PEAR_REST::downloadHttp (string $url, false|string|array [$lastmodified = null], false|array [$accept = false], string $save_dir)

Description

If an HTTP proxy has been configured (http_proxy PEAR_Config setting), the proxy will be used.

Parameter

string $url

the URL to download

FALSE|string|array $lastmodified

header values to check against for caching use FALSE to return the header values from this download

FALSE|array $accept

Accept headers to send. This should be a list of MIME types like text/xml, frog/legs, etc.

string $save_dir

directory to save file in

Return value

returns Returns the contents 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.

Throws

throws no exceptions thrown

Note

This function can not be called statically.

PrevHomeNext
constructor PEAR_REST::PEAR_REST()UpPEAR_REST::getCache()