# swoole\_http\_client->download [TOC] 通过Http下载文件。`download`与`get`方法的不同是`download`收到数据后会写入到磁盘，而不是在内存中对Http Body进行拼接。因此`download`仅使用小量内存，就可以完成超大文件的下载。 函数原型： ~~~ function swoole_http_client->download(string $path, string $filename, callable $callback, int $offset = 0); ~~~ * $path URL路径 * $filename 指定下载内容写入的文件路径，会自动写入到`downloadFile`属性 * $callback 下载成功后的回调函数 * $offset 指定写入文件的偏移量，此选项可用于支持断点续传，可配合Http头`Range:bytes=$offset-`实现 * $offset为0时若文件已存在，底层会自动清空此文件 * 执行成功返回true * 打开文件失败或feek失败返回false ## 使用示例 ~~~ $cli = new swoole_http_client('127.0.0.1', 80); $cli->setHeaders([ 'Host' => "localhost", "User-Agent" => 'Chrome/49.0.2587.3', 'Accept' => '*', 'Accept-Encoding' => 'gzip', ]); $cli->download('/video.avi', __DIR__.'/video.avi', function ($cli) { var_dump($cli->downloadFile); }); ~~~ ## 断点续传 ~~~ $cli = new swoole_http_client('127.0.0.1', 80); $file = __DIR__.'/video.avi'; $offset = filesize($file); $cli->setHeaders([ 'Host' => "localhost", "User-Agent" => 'Chrome/49.0.2587.3', 'Accept' => '*', 'Accept-Encoding' => 'gzip', 'Range' => "bytes=$offset-", ]); $cli->download('/video.avi', $file, function ($cli) { var_dump($cli->downloadFile); }, $offset); ~~~