如何使用 PHP 和 MySQL 通过复选框导出数据库表数据到 CSV 文件-php教程-PHP中文网

如何使用 PHP 和 MySQL 通过复选框导出数据库表数据到 CSV 文件

本文详解如何安全、高效地将用户勾选的数据库记录导出为 csv 文件，重点修复因循环位置错误导致的表头重复和数据重复写入问题，并提供完整可运行的代码结构与关键注意事项。

本文详解如何安全、高效地将用户勾选的数据库记录导出为 csv 文件，重点修复因循环位置错误导致的表头重复和数据重复写入问题，并提供完整可运行的代码结构与关键注意事项。

在基于 PHP + MySQL 的数据导出功能中，一个常见需求是：让用户通过复选框（checkbox）选择多行记录，再一键导出为 CSV 文件。但如示例所示，若逻辑处理不当——尤其是 fseek() 和 HTTP 头部发送的位置错误——会导致 CSV 文件中表头重复出现、每条数据被多次写入，最终生成内容错乱、无法解析的文件。

? 核心问题定位

原代码中，fseek($f, 0) 和 header()、fpassthru() 被错误地置于 foreach 循环内部。这意味着：每处理一个勾选项，就重置文件指针、发送响应头、输出全部缓冲内容一次。结果就是：3 个勾选项 → CSV 表头写入 3 次 + 数据重复 3 轮，造成严重冗余。

✅ 正确实现逻辑（关键修正）

必须确保：

QuickBooks Mileage CSV

使用 qbo-mileage CLI 及用户凭证，从 Airtable、Outlook 或 Google Calendar 记录生成 QuickBooks Online 里程 CSV 文件。

下载

所有数据（含表头）一次性写入内存文件流；
fseek(0) 仅在写入全部内容后调用一次，将指针归位至起始；
HTTP 响应头与 fpassthru() 全局执行一次，触发浏览器下载。

以下是修复后的核心 PHP 导出逻辑（已优化安全性与健壮性）：

<?php session_start();
if (!isset($_SESSION['id_usuario'])) {
    exit('Acceso denegado: sesión no válida.');
}

require_once 'db_connection.php'; // 确保已建立 $mysqli 连接

// 验证并获取勾选项
if (!isset($_POST['casilla']) || !is_array($_POST['casilla']) || empty($_POST['casilla'])) {
    exit('No se ha seleccionado ningún registro para exportar.');
}

// 清理输入（防 SQL 注入：必须使用预处理）
$ids = array_map('intval', $_POST['casilla']); // 强制转整型
$idList = implode(',', $ids);

$delimiter = ",";
$filename = "Partidas_Abiertas_" . date('Y-m-d_H-i-s') . ".csv";

// 创建内存文件流
$f = fopen('php://memory', 'w');

// 写入 CSV 表头（严格对应字段顺序）
$headers = ['Cuenta', 'NombreCliente', 'KZz', 'zv', 'Doc.Factura', 'Fecha_Factura', 'Venc.Neto', 'Importe_en_ML', 'texto'];
fputcsv($f, $headers, $delimiter);

// 批量查询勾选记录（推荐：单次查询优于循环查询）
$sql = "SELECT cuenta, nCliente, kzz, zv, docFac, fechaDoc, vencNeto, importe, texto 
        FROM partidas 
        WHERE id_partida IN ($idList)";
$result = $mysqli->query($sql);

if ($result && $result->num_rows > 0) {
    while ($row = $result->fetch_assoc()) {
        // 显式指定键名，避免未定义索引警告
        $data = [
            $row['cuenta'] ?? '',
            $row['nCliente'] ?? '',
            $row['kzz'] ?? '',
            $row['zv'] ?? '',
            $row['docFac'] ?? '',
            $row['fechaDoc'] ?? '',
            $row['vencNeto'] ?? '',
            $row['importe'] ?? '',
            $row['texto'] ?? ''
        ];
        fputcsv($f, $data, $delimiter);
    }
} else {
    // 若无匹配数据，至少保留表头（空文件仍合法）
}

// ⚠️ 关键：所有写入完成后，才重置指针并输出
fseek($f, 0);

// 设置响应头（必须在 fpassthru 前且仅一次）
header('Content-Type: text/csv; charset=utf-8');
header('Content-Disposition: attachment; filename="' . $filename . '"');
header('Cache-Control: must-revalidate, post-check=0, pre-check=0');
header('Expires: 0');
header('Pragma: public');

// 输出全部内容并关闭流
fpassthru($f);
fclose($f);
exit;
?>

?️ 重要注意事项与最佳实践

SQL 注入防护：绝对禁止字符串拼接 ID 查询！示例中使用 intval() 批量过滤，生产环境强烈推荐改用 PDO 预处理语句或 mysqli_prepare()。
字符编码：添加 charset=utf-8 到 Content-Type，避免中文等特殊字符乱码；若数据含 UTF-8 内容，可在写入前对 $data 数组执行 array_map('utf8_encode', $data)（需确认源数据编码）。
性能优化：将 N 次单条查询合并为 1 次 IN() 查询，显著减少数据库往返开销。
空值处理：使用 ?? '' 防止 fputcsv() 因 NULL 值报错或导出异常。
HTML 表单修正：原
中存在重复 method="post"，应删除一个；同时建议为提交按钮添加 type="submit" 并移除 target="_blank"（CSV 下载无需新窗口）。
错误兜底：导出前检查 $result 是否有效，避免空结果集导致空白 CSV。