WireHttp::download() method

Download a file from a URL and save it locally

First it will attempt to use CURL. If that fails, it will try fopen(), unless you specify a useMethod in $options.

Usage

// basic usage
$string = $http->download(string $fromURL, string $toFile);

// usage with all arguments
$string = $http->download(string $fromURL, string $toFile, array $options = []);

Arguments

NameType(s)Description
fromURLstring

URL of file you want to download.

toFilestring

Filename you want to save it to (including full path).

options (optional)array

Optional aptions array for PHP's stream_context_create(), plus these optional options:

  • use or useMethod (string): Specify "curl", "fopen" or "socket" to force a specific method (default=auto-detect).
  • timeout (float): Number of seconds till timeout.

Return value

string

Filename that was downloaded (including full path).

Exceptions

Method can throw exceptions on error:

  • WireException - All error conditions throw exceptions.


$http methods and properties

API reference based on ProcessWire core version 3.0.130

Twitter updates

  • New post: Quietly and without interruption this week, the ProcessWire.com website (and all subdomains) moved from a single static server to a load-balanced multi-server environment, giving us even more horsepower and redundancy than before— More
    19 April 2019
  • New post: With ProcessWire 3.0.130, this week we’ll take a detailed look at a few useful new API additions made in the last few weeks, along with examples of each—More
    12 April 2019
  • New post: This week ProcessWire ProMailer has been released, plus we’ve got a nice upgrade in our community support forum, and more— More
    15 March 2019

Latest news

  • ProcessWire Weekly #258
    In the 258th issue of ProcessWire Weekly we'll cover a hosting upgrade for the processwire.com site and it's subdomains, introduce PW Review and Terminal module, and feature the new site of O'Neil Cinema. Read on!
    Weekly.pw / 20 April 2019
  • ProcessWire.com website hosting upgrades
    Quietly and without interruption this week, our whole website moved from a single static server to a load-balanced multi-server environment, giving us even more horsepower and redundancy than before.
    Blog / 19 April 2019
  • Subscribe to weekly ProcessWire news

“…building with ProcessWire was a breeze, I really love all the flexibility the system provides. I can’t imagine using any other CMS in the future.” —Thomas Aull