如何在PHP中格式化MySQL查询结果后导出为CSV文件

我想要将MySQL查询结果导出为CSV文件，但需要先格式化特定字段再写入CSV。我已有可直接导出整行数据的正常运行代码：

header('Content-Type: text/csv; charset=utf-8');
header('Content-Disposition: attachment; filename=data.csv');
$output = fopen("php://output", "w");
fputcsv($output, array('ID', 'Name', 'Country', 'Province/City', 'Address', 'Gender', 'Track', 'Payment Option'));
$sql = "SELECT * FROM STUDENTINFO order by GRADELEVEL";
$result = $conn->query($sql);
if ($result->num_rows > 0) {
    while($row = $result->fetch_assoc()) {
        fputcsv($output, $row);
    }
fclose($output);

现希望对特定字段处理后导出，比如拼接姓名、转换GRADELEVEL描述、根据TRACK值替换文本等，我尝试了部分代码但需完善：

if ($result->num_rows > 0) {
    while($row = $result->fetch_assoc()) {
        $name = $row['FIRSTNAME'].' '.$row['MIDDLENAME'].' '.$row['LASTNAME'];
        $gradelevel = glvlDESCRIPTION($row['GRADELEVEL']);
        if ($row['TRACK'] == "AW") {
            $track = "A With Activities";
        } else {
            $track = "A Without Activities";
        }
        fputcsv($output, $row['STUDENTID'], $name, $row['COUNTRY'], $row['PROVINCE'], $row['ADDRESS'], $track...);
    }
fclose($output);

请求指导正确的实现方法。

没问题，咱们来修正这个代码！你当前代码里最核心的问题是fputcsv的用法不对——这个函数需要接收一个数组作为参数，而不是把每个字段单独传进去。下面是完整的修正版代码，完美实现你要的格式化需求：

header('Content-Type: text/csv; charset=utf-8');
header('Content-Disposition: attachment; filename=data.csv');
$output = fopen("php://output", "w");

// 定义CSV表头，注意要和后续输出的字段顺序完全匹配
$headers = array('ID', 'Name', 'Country', 'Province/City', 'Address', 'Gender', 'Track', 'Payment Option');
fputcsv($output, $headers);

$sql = "SELECT * FROM STUDENTINFO order by GRADELEVEL";
$result = $conn->query($sql);

if ($result->num_rows > 0) {
    while($row = $result->fetch_assoc()) {
        // 1. 格式化姓名：处理中间名为空的情况，避免出现多余空格
        $nameParts = array_filter([$row['FIRSTNAME'], $row['MIDDLENAME'], $row['LASTNAME']]);
        $fullName = implode(' ', $nameParts);

        // 2. 调用自定义函数转换年级描述
        $gradeLevel = glvlDESCRIPTION($row['GRADELEVEL']);

        // 3. 替换TRACK字段为友好文本，用三元运算符简化代码
        $track = $row['TRACK'] === "AW" ? "A With Activities" : "A Without Activities";

        // 4. 构建格式化后的行数组，顺序必须和表头完全一致！
        $formattedRow = [
            $row['STUDENTID'],       // ID列
            $fullName,               // 格式化后的姓名
            $row['COUNTRY'],         // 国家
            $row['PROVINCE'],        // 省/市
            $row['ADDRESS'],         // 地址
            $row['GENDER'],          // 性别
            $track,                  // 格式化后的Track
            $row['PAYMENT_OPTION']   // 支付方式（请根据你的数据库实际字段名调整）
        ];

        // 将格式化后的行写入CSV
        fputcsv($output, $formattedRow);
    }
}

fclose($output);
exit; // 添加exit防止额外输出破坏CSV文件结构

关键注意事项： #

• fputcsv的参数要求：一定要传数组！这样才能保证列和表头一一对应，不会出现错位。
• 处理空中间名：用array_filter()过滤掉空的姓名部分，避免出现类似John Doe这样的多余空格。
• 代码简化：用三元运算符替换了原来的if/else，让Track的逻辑更简洁。
• 列顺序一致性：务必保证$formattedRow里的字段顺序和表头$headers完全一致，否则数据会跑到错误的列里。
• 防止额外输出：最后加exit;是为了阻止PHP后续的输出（比如调试信息、空白字符）被写到CSV里，避免文件损坏。

另外要确认：

• 你的glvlDESCRIPTION()函数已经正确定义，能为每个GRADELEVEL返回正确的描述文本。
• 数据库里的字段名（比如支付方式的PAYMENT_OPTION）要和代码里的键名完全匹配，记得根据实际情况调整。

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