使用 fopen 和 fread 强制下载文件，核心在于设置正确的 http 响应头并逐块读取文件内容输出到标准输出。通过 header() 函数指定 content-type、content-disposition 以及文件大小，然后以二进制模式打开文件，利用循环配合 fread() 读取固定字节数（如 8192）直到文件末尾，最后关闭句柄。
fopen 打开文件时模式参数如何影响读取行为
在实现下载逻辑时，必须使用 'rb' 模式打开文件，这表示以只读方式且为二进制模式打开。如果使用 'r' 模式，在某些操作系统（如 Windows）上可能会因为自动转换换行符而导致下载的文件损坏或大小不一致。二进制模式确保读取的字节流与磁盘上的原始数据完全一致，这对于图片、压缩包或可执行文件的下载至关重要。
$file_path = '/var/www/html/data/report.pdf';
if (file_exists($file_path)) {
header('Content-Description: File Transfer');
header('Content-Type: application/octet-stream');
header('Content-Disposition: attachment; filename="' . basename($file_path) . '"');
header('Expires: 0');
header('Cache-Control: must-revalidate');
header('Pragma: public');
header('Content-Length: ' . filesize($file_path));
$handle = fopen($file_path, 'rb');
if ($handle !== false) {
while (!feof($handle)) {
echo fread($handle, 8192);
flush();
}
fclose($handle);
}
exit;
}
上述代码首先检查文件是否存在，随后发送一系列头部信息告知浏览器这是一个需要下载的附件。接着使用 fopen 以 'rb' 模式打开文件句柄。在 while 循环中，feof() 检测是否到达文件末尾，fread() 每次读取 8192 字节并通过 echo 直接输出。调用 flush() 可以确保数据立即发送给客户端，避免大文件下载时的缓冲延迟。最后务必调用 fclose() 释放资源。
立即学习“PHP免费学习笔记（深入）”；
大文件下载时内存占用与缓冲区大小的权衡
在处理大文件时，fread() 的第二个参数决定了每次从文件中读取多少字节并加载到内存中。如果该值设置过大，虽然减少了 I/O 次数，但会显著增加 PHP 进程的内存峰值；如果设置过小，则会导致大量的 I/O 操作，降低传输效率。通常建议设置为 8192 字节（8KB）或更大一点的 32768 字节，这在内存消耗和 I/O 性能之间取得了较好的平衡。
// 测试不同缓冲区大小对内存的影响
$buffer_sizes = [1024, 8192, 65536];
foreach ($buffer_sizes as $size) {
$start_mem = memory_get_usage();
$handle = fopen('/var/www/html/data/large_file.zip', 'rb');
while (!feof($handle)) {
$data = fread($handle, $size);
// 模拟处理，实际下载中直接 echo
}
fclose($handle);
$end_mem = memory_get_usage();
echo "Buffer Size: {$size}, Memory Delta: " . ($end_mem - $start_mem) . " bytes\n";
}
通过调整 fread() 的参数，开发者可以根据服务器内存状况优化下载脚本。较小的缓冲区适合内存受限的环境，而较大的缓冲区适合高吞吐量的场景。需要注意的是，无论缓冲区大小如何，最终输出的总字节数必须与 Content-Length 头部声明的大小完全一致，否则浏览器可能会报错或截断文件。
filesize() 获取文件大小失败时的异常处理
在发送 Content-Length 头部之前，代码调用了 filesize() 来获取文件的精确大小。如果文件路径错误、权限不足或文件被删除，filesize() 可能返回 false 或引发警告。此时如果直接将 false 转换为字符串并发送到头部，会导致浏览器无法正确解析内容长度，从而造成下载中断或无限等待。因此，必须在获取大小后验证其有效性，并在失败时给出适当的错误提示或终止脚本。
$file_path = '/var/www/html/data/missing.txt';
$file_size = @filesize($file_path);
if ($file_size === false) {
http_response_code(404);
die('File not found or inaccessible.');
}
header('Content-Length: ' . $file_size);
// ... 后续下载逻辑
在上述补充代码中，使用 @ 抑制了 filesize() 可能产生的警告，并显式检查返回值是否为 false。如果文件不可访问，脚本直接返回 404 状态码并终止，避免了后续无效的下载尝试。这种防御性编程确保了下载接口的健壮性，防止因元数据获取失败而导致的客户端体验问题。
