000webhost环境下CSV无法下载仅网页输出的解决办法

阿华AIGC实验室

2026-5-7

解决000webhost环境下PHP CSV无法下载的问题

我之前在000webhost的免费主机上碰到过一模一样的CSV导出问题，结合你的情况，给你几个针对性的排查和解决方法：

1. 修复HTTP Headers的输出逻辑

你的代码里Headers部分有格式问题，而且000webhost对Headers的发送时机要求很严格——必须在任何内容输出之前发送（包括文件开头的空格、BOM字符）。推荐替换成更严谨的Headers代码：

$file_name = 'data.csv';

// 清空所有输出缓冲区，避免提前输出内容导致Headers失效
ob_clean();
flush();

// 设置标准的CSV下载Headers
header("Content-Description: File Transfer");
header("Content-Disposition: attachment; filename=\"{$file_name}\""); // 给文件名加引号，兼容特殊字符
header("Content-Type: text/csv; charset=utf-8");
header("Expires: 0");
header("Cache-Control: must-revalidate");
header("Pragma: public");

// 后续的CSV写入代码...

另外一定要检查你的PHP文件开头有没有多余的空格、换行，或者编辑器保存时自动添加的UTF-8 BOM，这些都会导致Headers无法正常发送，直接输出CSV内容。

2. 处理输出缓冲区限制

000webhost的免费主机默认开启了输出缓冲，可能会干扰php://output的行为。你可以在代码开头添加输出缓冲控制：

ob_start(); // 开启缓冲区

// ... 你的数据库查询、CSV写入代码 ...

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

或者直接替换php://output为临时文件写入，绕过输出缓冲限制：

$file_name = 'data.csv';
$temp_file = tempnam(sys_get_temp_dir(), 'export_');
$file = fopen($temp_file, 'w');

// 写入表头
$header = array("value");
fputcsv($file, $header);

// 写入数据（注意修复SQL注入问题！）
$query = "SELECT * FROM data WHERE date >= :start_date AND date <= :end_date ORDER BY packet_id ASC";
$statement = $connect->prepare($query);
$statement->bindParam(':start_date', $_POST["start_date"]);
$statement->bindParam(':end_date', $_POST["end_date"]);
$statement->execute();
$result = $statement->fetchAll();

foreach($result as $row) {
    fputcsv($file, array($row["value"]));
}

fclose($file);

// 输出临时文件触发下载
ob_clean();
flush();
header("Content-Description: File Transfer");
header("Content-Disposition: attachment; filename=\"{$file_name}\"");
header("Content-Type: text/csv; charset=utf-8");
header("Content-Length: " . filesize($temp_file));
readfile($temp_file);

// 清理临时文件
unlink($temp_file);
exit;