通过 fpassthru 函数向浏览器发送压缩文件，有哪些实用方法和注意事项？

在 PHP 开发中，经常需要将服务器上的压缩文件（如 ZIP、GZ 等）直接发送到浏览器，供用户下载。 函数是一个高效的选择，它可以从文件指针读取文件内容，并直接输出到浏览器，而无需将整个文件加载到内存中。本文将介绍一些实用方法及注意事项。

一、fpassthru 的基本用法

fpassthru 的基本语法如下：

int fpassthru ( resource \$handle )

它会读取 \$handle 指向的文件直到文件结束，并将数据直接输出到浏览器，返回输出的字节数。

二、向浏览器发送压缩文件的步骤

"; echo "
1. 设置正确的 HTTP 头：确保浏览器知道这是一个文件下载请求。
"; echo "
2. 打开文件：使用 fopen 打开需要发送的压缩文件。
"; echo "
3. 使用 fpassthru 输出文件内容：直接将文件内容传输给浏览器。
"; echo "
4. 关闭文件指针：释放资源。
"; echo "

示例代码：

\$file = 'example.zip';
if (file_exists(\$file)) {
    header('Content-Description: File Transfer');
    header('Content-Type: application/zip');
    header('Content-Disposition: attachment; filename=\"' . basename(\$file) . '\"');
    header('Content-Transfer-Encoding: binary');
    header('Content-Length: ' . filesize(\$file));

    \$fp = fopen(\$file, 'rb');
    if (\$fp) {
        fpassthru(\$fp);
        fclose(\$fp);
        exit;
    }
}

三、实用方法

"; echo "
• 使用 readfile 或 fpassthru 避免一次性将大文件加载到内存。
"; echo "
• 配合 ob_clean() 和 flush() 清理输出缓冲区，保证文件正确传输。
"; echo "
• 通过 Content-Length 提前告知浏览器文件大小，提高下载体验。
"; echo "
• 对大文件可分块读取并输出，配合 set_time_limit(0) 防止超时。
"; echo "

四、注意事项

"; echo "
• 确保在发送文件之前没有任何输出，包括空格和 HTML，否则会破坏 HTTP 头。
"; echo "
• 正确设置 MIME 类型，如 ZIP 使用 application/zip，GZ 使用 application/gzip。
"; echo "
• 服务器权限需要允许 PHP 读取目标文件。
"; echo "
• 对大文件进行下载时，要考虑带宽限制和超时设置。
"; echo "

五、总结

使用 fpassthru 可以高效地将服务器上的压缩文件发送到浏览器，避免内存占用过高。在使用过程中，需要注意 HTTP 头设置、输出缓冲区处理以及文件权限等问题。掌握这些技巧，可以让文件下载功能更加稳定和高效。