CSV 导出:十万行也不爆内存
用 php://output 流式输出,边查边写,避免把整个结果集读进内存。处理了 Excel 打开中文乱码的问题。
更新于 2026-11-1522 行代码
完整代码
PHP
<?php
function export_csv(PDO $pdo, string $filename = 'export.csv'): void
{
$filename = preg_replace('/[^\w\-.]/', '_', $filename);
header('Content-Type: text/csv; charset=utf-8');
header('Content-Disposition: attachment; filename="' . $filename . '"');
header('Cache-Control: no-store');
header('X-Accel-Buffering: no');
$out = fopen('php://output', 'w');
fwrite($out, "\xEF\xBB\xBF"); // BOM,Excel 打开中文不乱码
fputcsv($out, ['ID', '标题', '分类', '发布时间']);
$st = $pdo->query('SELECT id, title, cat, created_at FROM articles ORDER BY id DESC');
while ($row = $st->fetch(PDO::FETCH_ASSOC)) {
fputcsv($out, [$row['id'], $row['title'], $row['cat'], $row['created_at']]);
}
fclose($out);
exit;
}
怎么用
- 在导出入口调用 export_csv($pdo, '文章列表.csv'),前面不要有任何输出。
- 数据量大时给查询加索引,逐行 fetch 本身不占内存。
- 导出接口建议加权限校验和频率限制,避免被反复拉全量数据。
注意
- BOM 会让 Excel 正确识别 UTF-8,但某些程序读到会多一个字符,按使用方决定加不加。
- x-Accel-Buffering: no 让 Nginx 不缓冲,用户能立刻开始下载。
- 内容里有逗号、引号、换行时 fputcsv 会自动加引号转义。