PHP图片下载在XAMPP正常但Jetthost主机无法运行求助

我碰到过好几个开发者遇到和你一模一样的问题——本地XAMPP跑的好好的图片下载功能，一部署到Jetthost主机就出问题，下载的图片打不开。结合你的代码和环境差异，咱们一步步排查：

核心可能的问题点及解决办法 #

1. 文件路径/大小写不匹配 #

XAMPP基于Windows系统，文件名和路径不区分大小写，但Jetthost主机大概率是Linux环境，大小写敏感程度很高。比如你代码里写的image/balloons.jpg，如果主机上实际文件夹是Image或者图片名是Balloons.jpg，PHP就会找不到文件。

排查&解决：

• 在download.php开头加一行测试代码，验证文件是否存在：

  var_dump(file_exists('image/balloons.jpg')); exit;
  

  访问页面如果输出bool(false)，说明路径错误。
• 改用绝对路径更稳妥，避免相对路径的坑：

  $filename = __DIR__ . '/image/balloons.jpg';
  

  __DIR__会指向当前PHP文件所在的目录，确保路径精准。

2. 文件/目录权限不足 #

主机上的PHP进程可能没有读取图片文件的权限，导致readfile()无法读取内容，下载的文件是空的或者损坏的。

排查&解决：

• 用FTP工具查看权限：image文件夹一般设为755，图片文件balloons.jpg设为644（或645，具体看主机要求）。
• 如果自己无法修改权限，直接联系Jetthost客服帮忙调整。

3. 输出缓冲或多余字符污染文件内容 #

本地环境可能没开启输出缓冲，但主机的PHP配置可能默认开启了output_buffering；另外如果download.php文件前后有多余的空格、换行，甚至是UTF-8 BOM头（部分编辑器保存时自动添加），这些多余字符会被加到下载的图片开头，导致图片损坏。

排查&解决：

• 把代码里的flush()换成更彻底的缓冲区清理：

  ob_end_clean(); // 清空并关闭所有输出缓冲区
  

• 检查download.php的首尾：确保<?php前面没有空格、换行，?>后面不要留任何字符（甚至可以直接删掉?>，PHP会自动处理）。

4. Content-Length设置错误 #

如果filesize($filename)因为路径或权限问题返回false，你设置的Content-Length就会是无效值，导致浏览器下载的文件不完整。

排查&解决：

• 先判断文件大小是否有效，再设置响应头：

  $filesize = filesize($filename);
  if ($filesize !== false) {
      header('Content-Length: ' . $filesize);
  }
  

  就算不设置这个头，浏览器也能正常下载，只是少了进度条而已，总比设置错误导致文件损坏好。

修改后的完整示例代码 #

结合上面的修复点，把你的download.php改成这样试试：

<?php
// 用绝对路径定位文件，避免相对路径问题
$filename = __DIR__ . '/image/balloons.jpg';

// 先检查文件是否存在且可读
if (!file_exists($filename) || !is_readable($filename)) {
    die('错误：无法找到或读取目标文件');
}

// 彻底清空所有输出缓冲区
ob_end_clean();

// 设置响应头
header('Content-Description: File Transfer');
header('Content-Type: image/jpeg'); // 用对应图片类型更准确
header("Cache-Control: no-cache, must-revalidate");
header("Expires: 0");
header('Content-Disposition: attachment; filename="' . basename($filename) . '"');

// 仅当文件大小有效时设置Content-Length
$filesize = filesize($filename);
if ($filesize !== false) {
    header('Content-Length: ' . $filesize);
}
header('Pragma: public');

// 读取并输出文件内容，比readfile更可控
$fileHandler = fopen($filename, 'rb');
if ($fileHandler) {
    fpassthru($fileHandler);
    fclose($fileHandler);
} else {
    die('错误：无法打开文件');
}

exit;
?>

先从路径和权限这两个最常见的问题查起，一般就能解决了。

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