PHP中readfile()方法打印文件而非触发下载的问题排查

你的代码逻辑本身没问题，但出现jar内容直接打印在页面上的情况，核心原因是下载相关的HTTP响应头没有被浏览器正确接收，导致浏览器无法识别这是一个下载请求。下面是具体的排查和修复步骤：

1. 确保没有任何提前输出（最常见原因） #

PHP的header()函数必须在任何实际输出之前调用——哪怕是一个空格、换行符，文件开头的UTF-8 BOM，甚至是之前代码里的echo、var_dump、错误提示，都会导致header被PHP自动忽略，浏览器就会把后续的二进制内容当成普通文本显示。

修复方法： #

• 检查你的PHP文件开头，<?php标签之前不能有任何字符（包括空格、换行），如果是UTF-8编码，确保文件用"无BOM UTF-8"格式保存。
• 在发送下载header之前，清空并关闭所有输出缓冲区：

  // 在session_start()之后、处理下载逻辑前添加
  ob_end_clean(); // 清空并关闭之前的输出缓冲区
  

2. 验证文件路径与可读性 #

如果目标文件不存在、路径错误或者PHP没有读取权限，filesize()会返回false，导致Content-length头无效，浏览器也无法正确识别下载请求。

修复方法： #

在处理header前添加文件状态检查：

$url = '/home/uploads/' . $p . '/' . $v . '.jar';

// 先验证文件状态
if (!file_exists($url)) {
    die("错误：文件不存在");
}
if (!is_readable($url)) {
    die("错误：PHP没有读取该文件的权限");
}

// 再获取文件大小
$fileSize = filesize($url);
if ($fileSize === false) {
    die("错误：无法获取文件大小");
}
header('Content-length: ' . $fileSize);

3. 优化Content-Disposition头的兼容性 #

文件名里包含空格（比如MyPlugin Snapshot-1.0.0.jar），部分老旧浏览器可能处理不当，甚至影响下载识别。

修复方法： #

采用RFC 5987标准的文件名格式，确保跨浏览器兼容：

$fileName = $p . ' ' . $v . '.jar';
header('Content-Disposition: attachment; filename*=UTF-8\'\'' . rawurlencode($fileName));

4. 确保readfile执行成功并终止脚本 #

readfile()如果执行失败（比如权限问题），可能会输出错误信息干扰下载流程，同时要确保脚本在readfile()后立即终止，避免后续代码输出内容。

修复方法： #

// 执行readfile并检查返回值
if (!readfile($url)) {
    die("错误：无法读取文件内容");
}
// 立即终止脚本
exit();

完整修复后的示例代码 #

<?php
session_start(); // 确保session_start在任何输出之前

// 清空输出缓冲区
ob_end_clean();

$p = $_GET['plugin'];
$v = $_GET['version'];

if (isset($p) && isset($v)) {
    if (in_array($p, getPlugins($_SESSION['username']))) {
        $url = '/home/uploads/' . $p . '/' . $v . '.jar';
        
        // 验证文件状态
        if (!file_exists($url) || !is_readable($url)) {
            die("无法下载：文件不存在或无读取权限");
        }
        
        $fileSize = filesize($url);
        $fileName = $p . ' ' . $v . '.jar';
        
        // 发送下载头
        header('Content-Description: File Transfer');
        header('Content-Type: application/java-archive');
        header('Content-Disposition: attachment; filename*=UTF-8\'\'' . rawurlencode($fileName));
        header('Expires: 0');
        header('Cache-Control: must-revalidate');
        header('Pragma: public');
        header('Content-Length: ' . $fileSize);
        
        // 输出文件并终止脚本
        if (!readfile($url)) {
            die("读取文件失败");
        }
        exit();
    } else {
        die("你没有权限下载该插件");
    }
} else {
    die("缺少必要参数");
}
?>

内容的提问来源于stack exchange，提问作者Lukas G