PHP生成CSV本地正常，添加下载选项后混入页面代码求助

问题描述 #

我是一名PHP初学者，正在编写脚本练习生成CSV文件。本地生成的CSV文件格式符合预期，但添加下载选项后，生成的CSV文件混入了整个PHP页面代码，格式错乱。相关代码如下：

<?php
include("db.php");
session_start();

$sql = "SELECT isocode FROM test_geo ORDER BY isocode";
$result_csv = mysqli_query($conn, $sql);

//facebook csv creation //
$filename = 'test.csv';
$fp = fopen($filename, 'w');
$headers = ['key', 'country'];

fputcsv($fp, $headers);
foreach ($result_csv as $key => $id) {
    $new = array_push($id, "country");

    fputcsv($fp, $id);
    var_dump($id);
}

fclose($fp);
?>

问题原因 #

1. 添加下载逻辑后未终止脚本执行，导致页面后续的PHP/HTML代码被一并输出到CSV文件中
2. 代码中的var_dump($id)会输出调试内容，污染CSV文件
3. 未正确设置HTTP响应头，浏览器无法识别这是一个CSV下载文件

修正方案 #

方案一：直接输出CSV下载（无需生成本地文件） #

<?php
include("db.php");
session_start();

$sql = "SELECT isocode FROM test_geo ORDER BY isocode";
$result_csv = mysqli_query($conn, $sql);

// 设置CSV下载响应头
header('Content-Type: text/csv; charset=utf-8');
header('Content-Disposition: attachment; filename="test.csv"');

// 直接输出到浏览器输出流
$output = fopen('php://output', 'w');
fputcsv($output, ['key', 'country']);

foreach ($result_csv as $row) {
    $row[] = "country";
    fputcsv($output, $row);
}

fclose($output);
// 终止脚本，防止后续内容输出
exit;
?>

方案二：保留本地文件同时提供下载 #

如果你需要保留本地CSV文件副本，可以用这个版本：

<?php
include("db.php");
session_start();

$sql = "SELECT isocode FROM test_geo ORDER BY isocode";
$result_csv = mysqli_query($conn, $sql);

$filename = 'test.csv';
$fp = fopen($filename, 'w');
fputcsv($fp, ['key', 'country']);

foreach ($result_csv as $row) {
    $row[] = "country";
    fputcsv($fp, $row);
}
fclose($fp);

// 触发下载
header('Content-Type: text/csv; charset=utf-8');
header('Content-Disposition: attachment; filename="' . $filename . '"');
readfile($filename);

// 终止脚本
exit;
?>

关键改动说明 #

• 移除var_dump($id)，避免调试信息混入CSV
• 使用php://output直接输出到浏览器（或读取本地文件输出）
• 添加exit语句，确保脚本输出CSV后立即停止，不会输出后续页面代码
• 正确设置HTTP响应头，明确告诉浏览器这是一个可下载的CSV文件

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