PHP代码怎么实现文件下载功能_PHP文件下载头信息设置方法-php教程-PHP中文网

PHP代码怎么实现文件下载功能_PHP文件下载头信息设置方法

星夢妙者

发布： 2025-10-18 19:23:01

原创

242人浏览过

答案是实现PHP文件下载需正确设置响应头并保障安全。首先通过header()设置Content-Type、Content-Disposition等头部，确保浏览器以附件形式下载；使用ob_clean()清除缓冲区，readfile()输出文件内容。针对中文文件名乱码，需根据用户代理对filename进行rawurlencode编码，兼容IE等浏览器。安全性方面，应将文件存于Web目录外，验证路径合法性，防止目录遍历，过滤用户输入。大文件可采用分段读取降低内存消耗，最终实现稳定安全的下载功能。

php代码怎么实现文件下载功能_php文件下载头信息设置方法

实现PHP文件下载功能，关键在于正确设置HTTP响应头信息，告诉浏览器不要直接打开文件，而是将其作为附件下载。同时要确保文件路径安全、文件存在且可读。

设置正确的下载头信息

通过header()函数发送特定的响应头，控制浏览器行为：

Content-Type：设置为application/octet-stream或application/download，表示二进制流，避免浏览器尝试解析
Content-Disposition：使用attachment; filename="xxx"提示浏览器下载并建议文件名
Content-Length：告知文件大小，有助于下载进度显示
Content-Transfer-Encoding：可选，一般设为binary

示例代码：

$filePath = 'uploads/example.pdf';
$fileName = basename($filePath);

if (file_exists($filePath) && is_readable($filePath)) {
    // 清除缓冲区防止输出干扰
    ob_clean();
    flush();

    // 设置头信息
    header('Content-Type: application/octet-stream');
    header('Content-Disposition: attachment; filename="' . urlencode($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;
} else {
    http_response_code(404);
    echo "文件未找到或不可读。";
}

登录后复制

处理中文文件名乱码问题

直接使用中文文件名可能导致下载时乱码。推荐做法是统一用英文名，或根据浏览器兼容方式编码：

立即学习“PHP免费学习笔记（深入）”；

代码小浣熊

代码小浣熊是基于商汤大语言模型的软件智能研发助手，覆盖软件需求分析、架构设计、代码编写、软件测试等环节

查看详情

使用rawurlencode()处理文件名
对IE等旧浏览器可添加filename*=UTF-8''参数

改进的文件名设置：

$ua = $_SERVER['HTTP_USER_AGENT'];
$encodedName = rawurlencode($fileName);

if (preg_match('/MSIE|Trident/', $ua)) {
    header('Content-Disposition: attachment; filename="' . $encodedName . '"');
} else {
    header('Content-Disposition: attachment; filename="' . $fileName . '"; filename*=UTF-8\'\'' . $encodedName);
}

登录后复制