在Web开发中，文件下载是一个常见需求。当面对几GB甚至更大的文件时，如果直接用readfile()或file_get_contents()读取整个文件再输出，极易导致PHP内存耗尽或超时错误。为解决这一问题，流式下载成为最佳实践方案。它通过逐块读取文件内容并实时输出到浏览器，极大降低服务器内存压力，同时支持断点续传和进度反馈。

为什么需要流式下载？

传统方式下载大文件时，PHP会将整个文件加载进内存，再通过HTTP响应发送给客户端。例如：

php readfile('large-file.zip');

这种方式看似简单，但对一个2GB的文件，PHP脚本至少需要占用2GB内存，远远超出默认配置（通常为128MB~512MB），导致“Allowed memory size exhausted”错误。此外，用户无法看到下载进度，体验较差。

流式下载的核心思想是“边读边发”，每次只读取一小部分数据（如8KB），发送后立即释放内存，从而实现低内存消耗下的稳定传输。

实现流式下载的基本步骤

首先，我们需要正确设置HTTP头信息，告知浏览器即将接收的是一个可下载的文件：

php
$filePath = '/path/to/your/large-file.zip';
if (!fileexists($filePath)) { httpresponse_code(404);
die('File not found.');
}

$fileName = basename($filePath);
$fileSize = filesize($filePath);

// 设置响应头
header('Content-Description: File Transfer');
header('Content-Type: application/octet-stream');
header('Content-Disposition: attachment; filename="' . $fileName . '"');
header('Content-Transfer-Encoding: binary');
header('Expires: 0');
header('Cache-Control: must-revalidate');
header('Pragma: public');
header('Content-Length: ' . $fileSize);
ob_clean();
flush();

接下来，使用fopen()打开文件，并配合fread()循环读取：

php $handle = fopen($filePath, 'rb'); if ($handle) { while (!feof($handle)) { // 每次读取8KB echo fread($handle, 8192); // 清除输出缓冲，立即发送数据 ob_flush(); flush(); } fclose($handle); } exit;

这样，无论文件多大，PHP进程始终只占用少量内存，真正实现了“以小博大”的高效传输。

使用X-Sendfile提升性能

虽然上述方法可行，但PHP仍需参与数据转发。更优方案是使用Web服务器提供的X-Sendfile功能（Apache、Nginx均支持）。它允许PHP仅设置特定Header，由服务器直接处理文件发送，完全脱离PHP进程。

Nginx配置示例：

nginx location /download/ { internal; alias /secure/files/; }

PHP代码：

php header('X-Accel-Redirect: /download/large-file.zip'); header('Content-Type: application/octet-stream'); header('Content-Disposition: attachment; filename="large-file.zip"'); exit;

此时PHP不再读取文件内容，极大减轻负载，适合高并发场景。

前端实现下载进度显示

由于流式下载发生在服务端，浏览器原生<a>标签无法获取实时进度。要实现进度条，需借助JavaScript的XMLHttpRequest或fetch API。

HTML结构：

html <a href="#" id="downloadLink">点击下载</a> <progress id="progressBar" value="0" max="100"></progress> <span id="percent">0%</span>

JavaScript监听下载过程：

javascript
document.getElementById('downloadLink').addEventListener('click', function(e) {
e.preventDefault();

const xhr = new XMLHttpRequest();
xhr.open('GET', 'download.php?file=large-file.zip', true);
xhr.responseType = 'blob';

xhr.onprogress = function(event) {
    if (event.lengthComputable) {
        const percent = Math.round((event.loaded / event.total) * 100);
        document.getElementById('progressBar').value = percent;
        document.getElementById('percent').textContent = percent + '%';
    }
};

xhr.onload = function() {
    if (xhr.status === 200) {
        const url = window.URL.createObjectURL(xhr.response);
        const a = document.createElement('a');
        a.href = url;
        a.download = 'large-file.zip';
        document.body.appendChild(a);
        a.click();
        window.URL.revokeObjectURL(url);
        document.body.removeChild(a);
    }
};

xhr.send();

});

该方法利用onprogress事件捕获已下载字节数，动态更新UI，让用户清晰掌握下载状态。

注意事项与优化建议

• 确保PHP的max_execution_time足够长，或设为0（不推荐生产环境）。
• 对敏感文件路径做好权限校验，防止越权访问。
• 可结合range请求支持断点续传。
• 生产环境优先使用X-Sendfile，减少PHP参与。

通过合理运用流式读取与前后端协同，我们不仅能安全高效地传输大文件，还能提供良好的用户体验。这才是现代Web应用应有的下载解决方案。