thinkphp 6.0 数据导出必须先判断量级和格式:小批量(≤5000行)用phpspreadsheet查完再写,设simsun字体、utf-8响应头、手动setcellvalue;中大批量(≥1万行)须用db::cursor()或游标分页+ fputcsv流式导出csv,配ob_end_clean()、bom头、fputs和fflush,禁用fromarray和边查边写。

ThinkPHP 6.0 实现数据导出必须先判断数据量级和格式需求:小批量(≤5000 行)可直接查出后用 PhpSpreadsheet 写 Excel;中大批量(≥1 万行)必须放弃全量加载,改用游标分页 + fputcsv 流式写 CSV,否则 PHP 进程必然触发 Allowed memory size exhausted 错误或超时中断。
小批量 Excel 导出(≤5000 行)
第一步:用 Composer 安装 PhpSpreadsheet
执行命令 composer require phpoffice/phpspreadsheet,确保版本 ≥1.21.0,旧版存在安全风险且不兼容 PHP 8.5.5。
第二步:控制器中查完数据再写入,禁止边查边写
调用 $data = Db::name('user')->select(); 获取全部结果,不要在 foreach 循环里嵌套查询——否则每行都触发一次 SQL,数据库连接数会迅速耗尽。
第三步:设置中文字体与响应头
必须执行 $spreadsheet->getDefaultStyle()->getFont()->setName('SimSun');,否则 Windows Excel 打开显示方块;【Content-Type 必须带 charset=utf-8】,缺了这句中文列名直接乱码。
第四步:手动循环写入,禁用 fromArray()
对每行数据调用 $sheet->setCellValue('A' . $row, $value),不要用 $sheet->fromArray($data) ——它会把所有字段转成字符串,日期变文本、数字变字符串,Excel 失去排序和求和能力。
中大批量 CSV 导出(≥1 万行)
方法一:用 Db::cursor()(仅限 TP6.0.12+ 或已打补丁版本)
调用 $cursor = Db::name('order')->cursor(); 替代 select(),它返回 PDOStatement 对象,不加载任何数据到内存;【严禁在此查询链上调用 with() 或 join()】,否则底层强制 toArray(),流式失效,内存立刻飙升。
方法二:用 where + order + limit 模拟游标分页(TP6 全版本通用)
选主键 id 作游标字段,首次查询 Db::name('log')->where('id', '>', 0)->order('id ASC')->limit(1000)->select(),记录最后 id;下次查询 where('id', '>', $lastId),循环直到无数据;【created_at 不可单独作游标字段】,时间重复会导致漏行或重复导出。
这一步操作起来很简单,直接把文件拖进去就行。
流式输出关键配置
① 输出前清空所有缓冲:ob_end_clean();,否则 HTML 模板残留的空白符会混进 CSV 开头,Excel 打开报错“文件已损坏”。
② 强制写入 BOM 头:fputs($fp, "\xEF\xBB\xBF");,Windows Excel 默认用 ANSI 解码,没这个三字节头,中文全变方块。
③ 用 fopen('php://output', 'w') + fputcsv 写入
不要拼字符串 echo,字段含逗号、换行、双引号时必然结构错乱;【fputcsv 第四、第五参数不可省略】,必须显式传入 ',' 和 '"',否则含双引号的文本会让 Excel 解析崩溃。
④ 每次 fputcsv 后紧跟 fflush($fp),把内核缓冲区内容推到客户端;不加这句,浏览器可能卡住几十秒才开始下载,用户以为失败而反复点击。
⑤ 设置超时与索引:set_time_limit(0); 关闭脚本超时,同时确保 ORDER BY 字段(如 id)有主键或二级索引,否则游标分页退化为全表扫描,导出过程从慢变成卡死。
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!











