ThinkPHP怎么做数据导出功能_ThinkPHP Excel和CSV数据导出实现方法【操作】-ThinkPHP-PHP中文网

thinkphp 数据导出核心是先明确量级和格式要求：小批量用 cursor() + fputcsv（注意bom）；excel 必选 phpspreadsheet，需 fromarray 分块写入、禁用计算引擎、直输 php://output。

thinkphp怎么做数据导出功能_thinkphp excel和csv数据导出实现方法【操作】

ThinkPHP 做数据导出，核心不是“选哪个库”，而是「先明确导出量级和格式要求」——小批量（PhpSpreadsheet 导 Excel 更稳妥；大批量或只要纯文本，直接用 fputcsv 写 CSV，内存占用低、速度快，且不依赖第三方。

为什么别用 `Db::select()` + `PhpSpreadsheet` 导 5w+ 数据

常见错误是把全部数据查出来再喂给 PhpSpreadsheet，结果 PHP 内存爆掉或超时。ThinkPHP 的查询结果集默认全加载进内存，PhpSpreadsheet 写入过程又额外吃内存，两者叠加极易触发 Fatal error: Allowed memory size exhausted。

正确做法：对大数据量，改用游标分页 + 流式写入（Excel 不支持真流式，所以优先降级为 CSV）
若必须导 Excel，用 PhpSpreadsheet 的 setCellValueByColumnAndRow() 手动控制单元格，避免 fromArray() 一次性导入大数组
导出前加 ini_set('memory_limit', '512M'); 是临时补救，不是解法

CSV 导出：用原生 `fputcsv`，绕过框架封装更可控

ThinkPHP 自带的 exportCsv 辅助方法（如某些插件提供）往往封装过深，字段顺序、BOM 头、中文乱码、空值处理都容易失控。直接操作文件句柄反而清晰。

QuickBooks Mileage CSV

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

下载

务必在输出前调用 ob_end_clean() 清除缓冲区，否则 CSV 文件开头会混入 HTML 或空白符
中文字段需写 BOM 头：echo "\xEF\xBB\xBF";，否则 Excel 默认用 ANSI 打开导致乱码
字段含逗号、换行或引号时，fputcsv 会自动加双引号并转义，不用手动处理
示例关键片段：

header('Content-Type: text/csv; charset=utf-8');
header('Content-Disposition: attachment; filename="data_' . date('YmdHi') . '.csv');
echo "\xEF\xBB\xBF";
$fp = fopen('php://output', 'w');
fputcsv($fp, ['ID', '用户名', '创建时间']); // 表头
$data = Db::name('user')->cursor(); // 游标查询，逐行取
foreach ($data as $row) {
    fputcsv($fp, [$row['id'], $row['name'], $row['create_time']]);
}
fclose($fp);

Excel 导出：用 `PhpSpreadsheet` 但避开内存陷阱

如果业务硬性要求 Excel（比如要公式、合并单元格、样式），PhpSpreadsheet 是当前 ThinkPHP 生态最可靠的选择，但要注意初始化方式和写入节奏。

不要用 new Spreadsheet() 后反复 getActiveSheet()->setCellValue() —— 单元格对象堆积会导致内存飙升
改用 getActiveSheet()->fromArray($chunk, NULL, 'A1')，每次只传 500~1000 行数组，并及时调用 unset($chunk)
禁用计算引擎：$spreadsheet->setCalculationEngine(new \PhpOffice\PhpSpreadsheet\Calculation\Calculation()); 可省 20% 内存
导出大文件时，用 $writer->save('php://output')，别先保存到临时文件再读取，避免磁盘 I/O 拖慢响应

真正卡住人的从来不是“怎么调一个导出函数”，而是数据量一上来就内存溢出、中文变成问号、Excel 打不开提示“文件损坏”。这些细节藏在 fputcsv 的 BOM 头里、藏在 cursor() 查询的游标行为里、也藏在 PhpSpreadsheet 每次 fromArray 的 chunk 大小里——没踩过坑的人，往往在生产环境第一次导 2w 条数据时才意识到。