答案是：PHP实现文件下载需设置Content-Disposition等响应头，验证文件存在性与可读性，处理中文名兼容性并防范路径遍历。1. 设置Content-Type、Content-Disposition、Content-Length等头部；2. 使用ob_clean()清除缓冲，readfile()输出内容；3. 中文名用rawurlencode()编码，支持filename*=UTF-8语法；4. 文件存于Web目录外，过滤用户输入，防止安全风险。
在PHP中实现文件下载功能，关键在于正确设置HTTP响应头，告诉浏览器不要直接显示文件内容，而是将其作为附件下载。这个过程涉及几个核心的响应头设置，尤其是Content-Disposition，同时需要确保文件存在、可读，并控制输出缓冲避免乱码或损坏。
1. 基本响应头设置
要让浏览器触发文件下载，必须发送正确的响应头。以下是常用的设置：
-
Content-Type：指定文件的MIME类型。如果不确定，可以使用
application/octet-stream表示二进制流。 -
Content-Disposition：设置为
attachment表示下载，可指定默认文件名。 - Content-Length：告知文件大小，有助于浏览器显示进度。
-
Content-Transfer-Encoding：通常设为
binary，适用于二进制文件。
header('Content-Type: application/octet-stream');
header('Content-Disposition: attachment; filename="example.pdf"');
header('Content-Length: ' . filesize($filePath));
header('Content-Transfer-Encoding: binary');
header('Expires: 0');
header('Cache-Control: must-revalidate');
header('Pragma: public');
2. 完整的文件下载示例代码
以下是一个安全且实用的PHP文件下载函数，包含路径验证和中文文件名处理：
function downloadFile($filePath, $downloadName = null) {
// 检查文件是否存在且可读
if (!file_exists($filePath) || !is_readable($filePath)) {
http_response_code(404);
die('文件不存在或无法读取。');
}
// 获取真实文件名（如果没有传入自定义名称）
$fileName = $downloadName ?: basename($filePath);
// 清除输出缓冲区，防止额外输出破坏文件
ob_clean();
flush();
// 设置响应头
header('Content-Type: application/octet-stream');
header('Content-Disposition: attachment; filename="' . urlencode($fileName) . '"');
// 对于IE等旧浏览器，可能需要UTF-8编码处理
header('Content-Disposition: attachment; filename*=UTF-8\'\'' . rawurlencode($fileName));
header('Content-Length: ' . filesize($filePath));
header('Content-Transfer-Encoding: binary');
header('Expires: 0');
header('Cache-Control: must-revalidate');
header('Pragma: public');
// 读取并输出文件内容
readfile($filePath);
exit;
}
// 使用示例
$filePath = '/path/to/your/file.pdf';
downloadFile($filePath, '我的文档.pdf');
3. 处理中文文件名兼容性
中文文件名在不同浏览器中可能乱码，建议使用rawurlencode或mb_convert_encoding处理。现代浏览器支持filename*语法：
立即学习“PHP免费学习笔记（深入）”；
- 使用
rawurlencode($fileName)处理URL编码。 - 添加
filename*=UTF-8''...格式提高兼容性。
4. 安全注意事项
实现下载功能时需注意安全问题：
- 不要直接暴露服务器路径，使用映射或白名单机制。
- 对用户传入的文件参数进行过滤，防止路径遍历（如
../）。 - 建议将文件存放在Web根目录之外，通过PHP读取后输出。
- 大文件可考虑使用
readfile()配合fopen()分块读取，避免内存溢出。
基本上就这些。只要设置好响应头，验证文件合法性，并处理好中文名和安全问题，PHP实现文件下载就很稳定可靠。
