在php中，通过设置http响应头`content-disposition`可以控制浏览器对文件的行为，其中`attachment`用于强制下载，而`inline`用于尝试在浏览器内预览。实现强制下载的核心是发送`content-type: application/octet-stream`并配合`content-disposition: attachment; filename="..."`，这会指示浏览器将内容视为需要保存的附件而非可渲染页面。
Content-Disposition头部的具体行为差异是什么
当头部设置为`inline`时，如果浏览器支持该MIME类型（如图片、PDF或文本），它通常会直接在标签页中打开文件；若不支持，则可能触发下载。相反，`attachment`会绕过浏览器的内置查看器，直接弹出“另存为”对话框或自动开始下载流，无论文件类型如何。这种区别主要取决于用户代理（浏览器）对`Content-Disposition`指令的解析逻辑。
<?php
// 假设有一个名为 report.pdf 的文件
$filename = 'report.pdf';
$file_path = '/path/to/' . $filename;
if (file_exists($file_path)) {
// 强制下载模式
header('Content-Description: File Transfer');
header('Content-Type: application/octet-stream');
header('Content-Disposition: attachment; filename="' . basename($filename) . '"');
header('Expires: 0');
header('Cache-Control: must-revalidate');
header('Pragma: public');
header('Content-Length: ' . filesize($file_path));
// 清除输出缓冲，确保二进制数据不被干扰
ob_clean();
flush();
readfile($file_path);
exit;
}
?>
上述代码演示了标准的强制下载流程。关键点在于`readfile`函数直接输出文件内容到输出缓冲区，配合`ob_clean()`防止之前的HTML或错误信息混入二进制流。如果将`Content-Disposition`改为`inline`，且浏览器能识别PDF，用户将看到文档内容而非下载进度条。
立即学习“PHP免费学习笔记（深入）”；
如何处理文件名中的特殊字符以确保兼容性
文件名中包含非ASCII字符（如中文）时，直接使用`basename()`可能导致乱码或下载失败。现代浏览器通常支持UTF-8编码的文件名，但为了兼容旧版IE或特定环境，建议使用RFC 5987标准格式，即使用`filename*=UTF-8''...`语法。这允许服务器明确指定字符集，避免浏览器猜测编码导致的错误。
<?php
$filename = '报告_2023.pdf';
$file_path = '/path/to/' . $filename;
if (file_exists($file_path)) {
header('Content-Type: application/octet-stream');
// 使用 RFC 5987 格式处理 UTF-8 文件名
header('Content-Disposition: attachment; filename="' . urlencode($filename) . '"; filename*=UTF-8\'\''. rawurlencode($filename));
header('Content-Length: ' . filesize($file_path));
ob_clean();
flush();
readfile($file_path);
exit;
}
?>
这段代码展示了更健壮的文件名处理方式。`rawurlencode()`确保特殊字符被正确转义，而`filename*`参数提供了明确的UTF-8标识。在实际测试中，Chrome和Firefox均能正确显示中文文件名并执行下载，而旧版IE可能需要额外的JavaScript降级方案，但在纯PHP后端层面，这是最通用的做法。
当文件不存在时程序应返回什么状态码
在文件下载脚本中，如果请求的文件路径无效或文件不存在，程序不应继续执行`readfile`，而应立即终止并返回404 Not Found状态码。这不仅符合HTTP规范，也能避免向客户端发送空内容或错误信息，同时记录服务器端的访问异常。通过检查`file_exists()`的结果，可以在发送任何头部之前设置正确的状态码。
<?php
$filename = 'missing_file.txt';
$file_path = '/path/to/' . $filename;
if (!file_exists($file_path)) {
http_response_code(404);
echo "File not found";
exit;
}
header('Content-Type: application/octet-stream');
header('Content-Disposition: attachment; filename="' . $filename . '"');
header('Content-Length: ' . filesize($file_path));
ob_clean();
flush();
readfile($file_path);
?>
此片段验证了错误处理逻辑。当`file_exists`返回false时，`http_response_code(404)`立即生效，后续代码不再执行。这确保了客户端收到明确的错误信号，而不是一个空的下载文件或意外的HTML错误页面。这种结构保证了程序的健壮性，特别是在处理用户上传或动态生成的文件时。
