fputcsv是唯一符合RFC 4180标准的PHP原生CSV写入函数，能自动转义双引号、包裹特殊字符字段、处理嵌入换行符，避免手拼字符串导致的列偏移、解析失败和乱码问题。
fputcsv 是唯一靠谱的选择，别拼字符串、别用 header("Content-type:application/vnd.ms-excel") 冒充 CSV —— Excel 乱码、字段错位、双引号吞数据，全是因为绕开了它。
为什么不能手拼 CSV 字符串
手写 implode(',', $row) 或字符串拼接（比如 "\"$a\",\"$b\"\n"）在真实业务中几乎必崩。只要字段含逗号、换行、双引号，CSV 就会解析失败 —— Excel 打开后列偏移、行断裂、中文变问号都是表象，根子是格式非法。
而 fputcsv() 会自动：转义双引号（" → ""）、包裹含特殊字符的字段、处理嵌入换行符。这是 PHP 唯一原生支持 RFC 4180 的 CSV 写入函数。
常见错误现象：
立即学习“PHP免费学习笔记（深入）”；
- 导出后 Excel 显示“文本导入向导”弹窗，说明格式不规范
- 某列突然多出一整段 HTML 或 JSON，其实是字段里的换行没被包裹
- 中文字段开头出现乱码（如 `姓名`），是缺 UTF-8 BOM
导出到浏览器下载必须设对这三样
在 phpEnv（或任何 PHP 环境）下让 MySQL 数据直接下载为 CSV，关键不是“生成文件”，而是让浏览器正确识别并触发保存。
必须按顺序做：
从 CSV 数据集生成图数据库加载器和三元组映射。将表格 CSV 数据转换为图数据库可直接使用的节点、边和三元组。
- 调用
ob_end_clean()清空所有前置输出（包括 BOM、空格、echo、var_dump） - 设置三个核心 header：
header('Content-Type: text/csv; charset=utf-8')、header('Content-Disposition: attachment; filename="data_'.rawurlencode(date('Y-m-d')).'.csv"')、header('Cache-Control: no-cache') - 用
fopen('php://output', 'w')打开输出流，而不是写本地文件路径
漏掉 ob_end_clean() 或提前有输出，会导致 header 失效，浏览器直接渲染 CSV 文本而非下载。
MySQL 查询结果怎么喂给 fputcsv
fputcsv() 只接受索引数组（[0 => 'a', 1 => 'b']），但 mysqli_fetch_assoc() 或 PDO::FETCH_ASSOC 返回的是关联数组（['name' => 'a', 'email' => 'b']），直接传会写空行或报 warning。
正确做法：
- 表头用
array_keys($firstRow)提取，再fputcsv($fp, $headers) - 数据行统一用
mysqli_fetch_row()或$stmt->fetch(PDO::FETCH_NUM) - 如果必须用关联查询（比如要字段别名），则每行调用
array_values($row)转索引
性能影响：用 FETCH_NUM 比 FETCH_ASSOC 内存占用低约 15%～20%，大数据量时更稳。
大表导出（>10 万行）不卡死的关键动作
一次性 fetchAll() 到内存，PHP 很容易触发 Fatal error: Allowed memory size exhausted。phpEnv 默认内存限制常为 128M，撑不住百万级记录。
必须流式处理：
- PDO 需禁用缓冲：
$pdo->setAttribute(PDO::MYSQL_ATTR_USE_BUFFERED_QUERY, false) - 循环中只用
fetch()，不用fetchAll() - 每写 1000 行调一次
ob_flush()+flush()，防 Web 服务器（如 Apache/Nginx）缓存阻塞 - 避免在循环里查关联表、调用 date() 格式化 —— 全部挪到 SQL 里用
DATE_FORMAT(created_at, '%Y-%m-%d')处理
最容易被忽略的一点：导出脚本超时。phpEnv 的 max_execution_time 默认常为 30 秒，大表务必加 set_time_limit(0)，且确认 php-fpm 的 request_terminate_timeout 也已放宽。
