如何实现PHP+MySQL站点HTML表格指定列一键导出为CSV文件

该方案直接对接MySQL查询，性能高、兼容大数量导出，是生产环境的首选方案。

实现逻辑 #

复用现有表格的查询条件，仅按需查询用户指定的列，通过PHP原生方法直接输出CSV流到浏览器，无需生成临时文件，开发成本最低。

具体步骤 #

1. 前端配置导出触发入口 #

支持两种交互模式，按需选择：

• 固定导出指定3列：直接添加一个导出按钮，点击后跳转/提交到服务端导出接口即可
• 用户自定义选择列：在表格上方添加列勾选框，用户勾选后提交选中的列参数到服务端
  示例前端代码：

<!-- 自定义列导出示例 -->
<div class="export-box">
  <label><input type="checkbox" name="export_cols" value="order_id" checked> 订单编号</label>
  <label><input type="checkbox" name="export_cols" value="buyer_name" checked> 买家名称</label>
  <label><input type="checkbox" name="export_cols" value="pay_amount" checked> 支付金额</label>
  <!-- 剩余4列可选 -->
  <label><input type="checkbox" name="export_cols" value="create_time"> 下单时间</label>
  <button type="button" onclick="document.getElementById('exportForm').submit()">导出CSV</button>
  <form id="exportForm" method="get" action="/export_csv.php" target="_blank"></form>
</div>

2. 服务端参数校验（防注入核心步骤） #

必须做列名白名单校验，禁止直接将用户传入的参数拼接SQL：

<?php
// 配置允许导出的列白名单，键为数据库字段名，值为CSV表头名称
$allowExportCols = [
    'order_id' => '订单编号',
    'buyer_name' => '买家名称',
    'pay_amount' => '支付金额',
    'create_time' => '下单时间',
    'status' => '订单状态',
    'express_no' => '快递单号',
    'remark' => '备注'
];

// 接收选中的列，默认导出3列
$reqCols = $_GET['export_cols'] ?? ['order_id', 'buyer_name', 'pay_amount'];
// 过滤非法列，仅保留白名单内的字段
$selectCols = array_filter((array)$reqCols, fn($col) => isset($allowExportCols[$col]));
if (empty($selectCols)) {
    die('请至少选择一列导出');
}

3. 查询数据并输出CSV #

使用PHP原生fputcsv方法自动处理特殊字符转义，避免手动拼接CSV出现格式错误：

<?php
// 复用你现有渲染表格的查询条件，比如筛选、排序规则
$colStr = implode(',', array_keys($selectCols));
$sql = "SELECT {$colStr} FROM 你的表名 WHERE 你的查询条件 ORDER BY id DESC";
$queryRes = mysqli_query($yourDbConn, $sql);

// 设置下载响应头
header('Content-Type: text/csv; charset=utf-8');
header('Content-Disposition: attachment; filename="订单数据_'.date('YmdHis').'.csv"');
// 输出UTF-8 BOM头，解决Windows下Excel打开中文乱码问题
echo "\xEF\xBB\xBF";

$fp = fopen('php://output', 'w');
// 写入CSV表头
fputcsv($fp, array_values(array_intersect_key($allowExportCols, array_flip($selectCols))));
// 逐行写入数据
while ($row = mysqli_fetch_assoc($queryRes)) {
    fputcsv($fp, $row);
}
fclose($fp);
exit;
?>

轻量备选方案（仅适合单页小数据量场景） #

如果你的数据单页最多几百条，不需要导出全量分页数据，可以直接用前端JS读取当前表格内容导出，无需修改服务端代码：

document.getElementById('exportCsvBtn').addEventListener('click', () => {
  // 配置要导出的列索引，比如7列中的第0、1、2列
  const exportColIndex = [0, 1, 2];
  let csvStr = "\xEF\xBB\xBF"; // BOM头解决乱码
  
  // 遍历表格行
  document.querySelectorAll('table tr').forEach(tr => {
    const rowArr = [];
    exportColIndex.forEach(idx => {
      const cellText = tr.children[idx]?.innerText?.replace(/"/g, '""') || '';
      rowArr.push(`"${cellText}"`);
    });
    csvStr += rowArr.join(',') + '\r\n';
  });

  // 触发下载
  const blob = new Blob([csvStr], { type: 'text/csv' });
  const url = URL.createObjectURL(blob);
  const a = document.createElement('a');
  a.href = url;
  a.download = `导出数据_${Date.now()}.csv`;
  a.click();
  URL.revokeObjectURL(url);
});

注意事项 #

• 单表导出数据超过1万条时，建议在服务端增加分批查询逻辑，避免内存溢出
• 禁止跳过列白名单校验，否则会存在SQL注入风险
• 不需要保留导出文件历史的场景，优先直接输出到浏览器流，不要生成服务器本地临时文件

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