在php中强制下载文件并设置mime类型，核心做法是发送特定的http响应头：使用 header('content-type: ...') 指定mime，配合 header('content-disposition: attachment; filename=...') 触发浏览器下载行为，最后通过 readfile() 输出文件内容。只要确保在输出任何html或空白字符之前调用这些函数，浏览器就会将响应体视为附件而非页面内容进行下载。
Content-Type 如何影响不同文件的下载表现
设置正确的 Content-Type 决定了浏览器是直接打开文件还是提示保存。对于 PDF、图片等二进制格式，必须明确声明其 MIME 类型；对于文本类文件如 CSV 或 JSON，若希望用户下载而非直接在浏览器渲染，同样需要指定对应的 MIME 并附加 attachment 指令。如果省略 Content-Type，浏览器可能根据文件扩展名猜测类型，导致某些文件被错误地内联显示。
<?php
// 假设我们要下载一个名为 report.csv 的文件
$file_path = '/path/to/report.csv';
if (file_exists($file_path)) {
// 1. 清除缓冲区，防止之前的输出干扰
if (ob_get_level()) {
ob_end_clean();
}
// 2. 设置标准 HTTP 缓存控制头
header('Pragma: public');
header('Expires: 0');
header('Cache-Control: must-revalidate, post-check=0, pre-check=0');
header('Content-Type: text/csv'); // 关键：设置 MIME 类型
// 3. 设置下载文件名，支持中文需编码
$filename = 'report_' . date('Ymd') . '.csv';
header('Content-Disposition: attachment; filename="' . $filename . '";');
header('Content-Length: ' . filesize($file_path));
// 4. 读取并输出文件
readfile($file_path);
exit;
} else {
http_response_code(404);
echo "File not found";
}
?>上述代码针对 CSV 文件进行了优化。当 Content-Type 设置为 text/csv 时，部分浏览器（如 Chrome）可能会尝试直接打开它，但因为我们同时设置了 Content-Disposition: attachment，浏览器会优先遵循下载指令。如果我们将 Content-Type 改为 application/octet-stream，则所有文件都会被视为二进制流，强制触发下载对话框，但这会失去对特定文件类型的语义支持。
立即学习“PHP免费学习笔记（深入）”；
如何处理非标准扩展名或动态生成的内容
当文件没有扩展名，或者内容是动态生成（如数据库查询结果导出）时，无法依赖文件系统扩展名来推断 MIME 类型。此时必须手动指定 Content-Type。对于动态内容，通常使用 application/octet-stream 作为通用二进制流类型，或者根据数据格式（如 JSON、XML）指定具体类型。关键在于，无论内容来源如何，Content-Disposition 中的 filename 参数提供了用户保存时的默认名称，弥补了无扩展名的缺陷。
<?php
// 模拟动态生成 JSON 数据
$data = [
'id' => 1,
'name' => 'Test User',
'status' => 'active'
];
$json_string = json_encode($data, JSON_PRETTY_PRINT);
// 清除输出缓冲
if (ob_get_level()) ob_end_clean();
// 设置 MIME 为 JSON
header('Content-Type: application/json');
// 设置下载文件名，即使内容是 JSON，也建议加 .json 后缀
$filename = 'user_data.json';
header('Content-Disposition: attachment; filename="' . $filename . '";');
// 输出长度
header('Content-Length: ' . strlen($json_string));
// 直接输出字符串
echo $json_string;
exit;
?>这段代码展示了动态内容的处理流程。由于 $json_string 是内存中的字符串，我们使用 strlen() 获取其字节长度，并通过 echo 直接输出。这里 Content-Type 设为 application/json，虽然大多数现代浏览器对 JSON 的下载行为与 octet-stream 类似，但显式声明有助于客户端应用（如 Postman 或特定编辑器）正确识别内容。如果未设置 Content-Disposition，浏览器可能会尝试在标签页中解析并显示 JSON，而不是下载文件。
中文文件名在 Content-Disposition 中的编码问题
在 Content-Disposition 头中直接使用中文文件名会导致乱码，因为 HTTP 头默认使用 ASCII 编码。RFC 6266 和 RFC 5987 规定了两种处理方式：一种是使用 URL 编码（Percent-encoding），另一种是使用 RFC 5987 的 filename*= 语法。在实际开发中，推荐使用 filename*=UTF-8''... 格式，因为它兼容性最好，能正确处理非 ASCII 字符。如果使用传统的 filename=... 且包含中文，必须进行 rawurlencode() 处理，但这种方式在某些旧版 IE 浏览器中可能表现不一致。
<?php
$file_path = '/path/to/报告.pdf';
$original_filename = '报告.pdf';
if (file_exists($file_path)) {
if (ob_get_level()) ob_end_clean();
header('Content-Type: application/pdf');
// 方法一：RFC 5987 推荐方式（兼容性好）
// filename 提供 fallback，filename* 提供 UTF-8 编码
header('Content-Disposition: attachment; filename="' . rawurlencode($original_filename) . '"; filename*=UTF-8\'\'' . rawurlencode($original_filename) . '";');
header('Content-Length: ' . filesize($file_path));
readfile($file_path);
exit;
}
?>在上述代码中，filename* 参数使用了 UTF-8'' 前缀，后跟经过 rawurlencode() 处理的文件名。这是目前最稳健的做法。例如，如果文件名是“报告.pdf”，编码后会变成“%E6%8A%A5%E5%91%8A.pdf”。浏览器会优先解析 filename*，从而正确显示中文。如果只使用 filename 而不进行 URL 编码，中文会被截断或变为问号。此外，Content-Type 设置为 application/pdf 确保 PDF 阅读器能正确关联该下载文件。
