PHP readfile函数报错：图片无法显示（附代码求排查）

我之前也碰到过一模一样的问题，咱们一步步拆解可能的原因和解决办法：

• 检查输出前的多余字符（最常见原因）
  如果你的PHP文件开头带了UTF-8 BOM，或者在调用sendImage()之前有任何隐性输出（比如不小心多打了空格、换行，或者之前有echo/print语句），这些额外字符会插在图片二进制数据的最前面，直接破坏浏览器的解析逻辑。
  解决办法：

  • 打开所有相关PHP文件，确保开头没有多余空格，并且保存为无BOM的UTF-8格式；
  • 在函数开头加入缓冲区清理代码，强制清空所有提前输出的内容：

    function sendImage(string $file, int $browser_cache = 2592000) {
        ob_clean(); // 清空输出缓冲区
        flush();    // 强制输出缓冲区残留内容（如果有的话）
        if (file_exists($file)) {
            // ... 原有代码逻辑
        } else {
            echo 'file does not exist';
        }
    }
    

• 验证MIME类型的准确性
  mime_content_type()函数在部分环境下可能依赖系统的mime数据库，存在识别不准确的情况。你可以换用更可靠的finfo扩展来获取MIME类型，或者针对已知图片类型手动指定：

  // 替换原有mime_content_type的代码
  $finfo = new finfo(FILEINFO_MIME_TYPE);
  $mime_type = $finfo->file($file);
  header("Content-Type: ". $mime_type);
  
  // 如果确定是PNG图片，也可以直接写死测试：
  // header("Content-Type: image/png");
  

• 确认Content-Length的匹配性
  如果目标图片文件在filesize()调用后被其他进程修改，返回的文件大小会和实际读取的二进制内容长度不一致，导致浏览器提前终止解析。你可以：

  • 直接注释掉Content-Length头，让服务器自动处理内容长度；
  • 调用filesize()前先刷新文件状态缓存：

    clearstatcache(true, $file); // 清除文件状态缓存，确保获取最新大小
    header('Content-Length: '.filesize($file));
    

• 检查readfile的执行权限
  readfile()可能因为PHP进程没有目标图片的读取权限而执行失败，导致没有输出任何图片内容。可以添加错误日志排查：

  $bytes_read = readfile($file);
  if ($bytes_read === false) {
      error_log("Failed to read image file: $file");
      exit;
  }
  

  同时确认图片文件的权限设置，确保PHP进程拥有读取权限。

最后，你可以用浏览器开发者工具的Network面板，查看请求的响应头和原始响应内容：

• 确认Content-Type是否为正确的image/png；
• 查看响应内容开头是否有多余的HTML标签、空格等字符。

内容的提问来源于stack exchange，提问作者Benny Thadikaran