ThinkPHP怎么处理大文件下载_ThinkPHP分块下载实现方法【操作】-ThinkPHP-PHP中文网

直接用 readfile() 下载大文件会超时或内存溢出，因其一次性将整个文件读入内存；应改用分块读取、流式输出，并禁用输出缓冲、设置正确响应头、规避中间件干扰、配置 Web 服务器参数。

thinkphp怎么处理大文件下载_thinkphp分块下载实现方法【操作】

为什么直接用 `readfile()` 下载大文件会超时或内存溢出

ThinkPHP 默认的 response()->download() 底层可能调用 readfile()，一次性把整个文件读进 PHP 内存再输出。100MB 的文件，PHP 就得分配至少 100MB 内存，还容易触发 max_execution_time 超时，Nginx 也可能在 60 秒后主动断连。

真正可行的做法是：不加载全文，而是分块读取、边读边输出，让响应流式传输。

禁用输出缓冲：ob_end_clean() 必须调用，否则 ob_start() 留下的缓冲会吃掉分块输出
设置合适的响应头：Content-Transfer-Encoding: binary 和 Content-Length（如果能预知大小）要准确，否则 Chrome 可能显示“已下载 0 字节”
避免框架中间件干扰：比如日志中间件、调试工具栏，在下载路由里应提前终止或跳过

用 `Response::stream()` 实现可控分块下载（TP6+）

ThinkPHP 6.1+ 提供了 Response::stream()，它接受一个回调函数，每次回调只处理一块数据，天然适合大文件场景。

关键不是“怎么写回调”，而是“怎么控制块大小和刷新节奏”：

推荐块大小设为 8192（8KB）：太小（如 512B）会频繁系统调用，太大（如 1MB）仍可能卡住低内存环境
每块后调用 flush() + ob_flush()，但必须确认 output_buffering 已关闭（ini_set('output_buffering', 'Off')）
文件路径必须用绝对路径，相对路径在 CLI 或异步请求中容易失效；建议用 app()->getRootPath() . 'public/uploads/large.zip'
记得手动设置 Content-Type，不要依赖 finfo_file() 自动探测——大文件探测本身就很慢

return Response::stream(function () {
    $file = fopen('/path/to/big-file.iso', 'rb');
    if (!$file) {
        throw new HttpException(404, 'File not found');
    }
    while (!feof($file)) {
        echo fread($file, 8192);
        flush();
        ob_flush();
    }
    fclose($file);
}, 200, [
    'Content-Type' => 'application/octet-stream',
    'Content-Disposition' => 'attachment; filename="big-file.iso"',
    'Content-Length' => filesize('/path/to/big-file.iso'),
]);