PHP数组导出CSV文件显示代码而非数组值的问题如何解决

问题根因排查与解决方法 #

1 先修正代码笔误 #

你贴出的导出代码第一行存在语法错误：

// 错误写法，漏了if的字母i
f(isset($_POST["download_csv"])){
// 正确写法
if(isset($_POST["download_csv"])){

如果实际运行代码也是这个写法，PHP会抛出未定义函数f()的错误，错误信息直接输出到下载流中，看起来就是代码内容而非预期数据。

2 核心问题：导出逻辑执行顺序错误 #

写本地文件正常是因为操作本地磁盘文件不会受页面输出影响，而用php://output输出下载内容时，所有提前输出的内容（包括HTML、PHP报错、空行空格）都会被拼入CSV文件，同时提前输出会导致header设置失效，浏览器无法识别为下载文件。
你遇到的两个现象都和顺序有关：

• 保留POST校验时，触发导出逻辑前已经输出了页面HTML，header设置失败，PHP抛出的headers already sent警告+后续输出的内容会被当做CSV内容
• 移除POST校验时，导出逻辑虽然执行了，但还是有提前输出的HTML，或是导出后没有立刻终止执行，后续的页面HTML被拼入CSV

3 修复步骤 #

3.1 调整代码结构，把导出逻辑放到文件最顶部

确保导出逻辑执行前没有任何输出（包括PHP标签外的空行、空格、echo语句、其他引入文件的输出），导出完成后立刻exit终止后续页面逻辑执行，参考结构：

<?php
// 顶部先处理导出逻辑，此处前面无任何内容
if (isset($_POST["download_csv"])) {
    // 在此处先生成/赋值要导出的$table数组，确保数组内容正确
    $fileName = 'csv-report.csv';

    // 可选：加BOM头解决中文乱码问题
    echo "\xEF\xBB\xBF";
    
    header("Cache-Control: must-revalidate, post-check=0, pre-check=0");
    header('Content-Description: File Transfer');
    header("Content-type: text/csv; charset=utf-8");
    header("Content-Disposition: attachment; filename={$fileName}");
    header("Expires: 0");
    header("Pragma: public");

    $fh = fopen('php://output', 'w');
    foreach ($table as $subids => $values) {
        fputcsv($fh, $values);
    }
    fclose($fh);
    // 导出完成直接终止，不会执行后续的页面逻辑
    exit;
}

// 下方才写普通页面逻辑、HTML输出代码
?>
<!DOCTYPE html>
<html>
<!-- 你的页面HTML内容 -->
<body>
    <!-- 导出表单确保是POST提交 -->
    <form method="post">
        <button type="submit" name="download_csv" value="1">导出CSV</button>
    </form>
</body>
</html>

3.2 移除不必要的错误抑制符

去掉fopen前的@符号，方便排查运行时错误。

3.3 清理文件首尾多余内容

确保<?php标签前没有任何空行、空格，文件末尾如果没有其他PHP代码，可以删掉闭合的?>标签，避免尾部意外输出空行。

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