如何使用GuzzleHttp下载大文件 7GB文件下载中途超时问题求解

• 配置参数位置错误：defaults配置仅适用于初始化Guzzle Client实例时使用，单次请求的配置需要直接写在请求选项的顶级层级，你当前设置的stream、read_timeout、timeout参数均未实际生效，是触发超时的核心原因。
• 总超时配置不合理：你代码中写的timeout仅为10秒，该参数代表整个请求的总超时时间，7GB大小的文件不可能在10秒内完成下载，会直接触发超时。
• Cookie参数类型错误：cookies选项要求传入CookieJarInterface实现类的实例，你当前赋值为字符串，会导致Cookie携带异常，可能触发服务端主动断开连接。

<?php
ini_set('memory_limit', '10000M');
ini_set("default_socket_timeout", 999999999);
// 命令行模式下max_execution_time默认无限制，网页模式建议确认fpm等相关超时配置也同步调整
ini_set('max_execution_time', 0);

use GuzzleHttp\Client;
use GuzzleHttp\Cookie\FileCookieJar;

// 初始化CookieJar，替换为你实际的Cookie文件路径
$jar = new FileCookieJar('./cookie.txt', true);

// 初始化Guzzle客户端，公共配置可以写在这里
$client = new Client([
    'timeout' => 0, // 总超时设为0表示无限制
    'read_timeout' => 600, // 连续600秒未读到数据才触发超时
    'cookies' => $jar
]);

$download_wbk_file = $client->request('GET', 'URL_FROM_WHICH_I_WANT_TO_DOWNLOAD_THE_FILE', [
    // 单次请求的配置直接写在该层级即可
    'sink' => './Testfile.wbk', // 注意替换为你实际需要的文件名
    'stream' => true,
    // 可以加进度回调监控下载状态
    'progress' => function ($downloadTotal, $downloadedBytes, $uploadTotal, $uploadedBytes) {
        if ($downloadTotal > 0) {
            $percent = round($downloadedBytes / $downloadTotal * 100, 2);
            echo "已下载：{$percent}%，{$downloadedBytes}/{$downloadTotal}\n";
        }
    }
]);
?>

• 如果是网页端触发的下载任务，建议同时调整PHP-FPM、Web服务器（Nginx/Apache）的超时配置，避免上层服务提前中断请求。
• 针对超大文件可以添加断点续传逻辑，通过Range请求头分段下载，单次请求失败后无需重新下载整个文件。
• 提前确认存储下载文件的磁盘分区剩余空间足够，避免写入失败导致的任务中断。

内容的提问来源于stack exchange，提问作者k r harsha