使用php强制下载图片文件（如jpg、png）的核心做法是设置http响应头并读取文件内容。你需要调用 header() 函数设置 content-type、content-disposition 和 content-length，然后使用 readfile() 输出文件流。这样做会覆盖浏览器默认的预览行为，强制触发浏览器的“另存为”对话框。如果文件不存在或路径错误，脚本应提前终止并返回404状态码，避免输出无效数据。
header() 中哪些参数决定了下载行为
决定下载行为的关键参数是 Content-Disposition: attachment。默认情况下，浏览器遇到图像 MIME 类型会尝试内联显示。通过显式指定 attachment，我们告诉浏览器这是一个附件而非可渲染资源。同时，filename 参数用于指定保存时的文件名，支持 UTF-8 编码的中文名称，需配合 basename() 清理路径中的目录部分以防止路径遍历攻击。
<?php
// 假设文件名为 image.jpg
$filename = 'image.jpg';
$path = '/var/www/images/' . $filename;
if (!file_exists($path)) {
http_response_code(404);
exit('File not found');
}
header('Content-Type: image/jpeg');
header('Content-Disposition: attachment; filename="' . basename($filename) . '"');
header('Content-Length: ' . filesize($path));
readfile($path);
exit;
?>
如何确保大文件下载时内存不溢出
readfile() 函数本身不会将整个文件加载到内存中，而是分块读取并直接写入输出缓冲区，因此它适合处理大文件。相比之下，如果使用 file_get_contents() 再 echo，则会将整个文件载入内存，可能导致 PHP 内存耗尽。对于超过几 MB 的图片，readfile() 是更安全的选择。此外，可以结合 flush() 和 ob_flush() 来优化网络传输体验，但核心在于避免全量加载。
立即学习“PHP免费学习笔记（深入）”；
<?php
// 对比：不安全的大文件处理方式
$content = file_get_contents('/var/www/images/large_image.png'); // 可能 OOM
header('Content-Type: image/png');
header('Content-Disposition: attachment; filename="large_image.png"');
echo $content;
// 推荐：安全的大文件处理方式
header('Content-Type: image/png');
header('Content-Disposition: attachment; filename="large_image.png"');
readfile('/var/www/images/large_image.png');
?>
当 Content-Type 设置错误时会发生什么
如果 Content-Type 设置为 application/octet-stream 或其他非图像类型，浏览器将不再尝试解析图像格式，而是直接将其视为二进制数据流进行下载。这虽然也能实现下载功能，但会导致用户无法在本地预览缩略图，且某些客户端可能无法正确识别文件扩展名。正确的做法是根据实际文件后缀动态设置 MIME 类型，例如 JPG 对应 image/jpeg，PNG 对应 image/png，以确保兼容性和用户体验。
