ThinkPHP模型导出_ThinkPHP数据导出指南【操作】-ThinkPHP-PHP中文网

导出前必须调用 toarray() 或 hidden() 等模型方法，因 thinkphp 模型对象非数组，直接传给 fputcsv() 或 phpspreadsheet 会报错或输出空白；需先 toarray() 转换，再通过 hidden()/visible()/append() 过滤或追加字段，注意 append 字段名须严格对应驼峰命名的获取器方法，且避免与数据库字段同名；大数据量导出应避免 fromarray()，改用分批 setcellvalue() 并手动触发垃圾回收；日期、金额等字段导出前需统一格式化为字符串，excel 中文乱码需设置字体，csv 中文乱码需在开头写入 bom。

thinkphp模型导出_thinkphp数据导出指南【操作】

导出前必须调用 `toArray()` 或 `hidden()` 等模型方法

ThinkPHP 的模型对象不能直接传给 fputcsv() 或 PhpSpreadsheet 的 fromArray()，否则会抛出类型错误或输出空内容。模型实例不是数组，它内部封装了数据、获取器、关联等逻辑，导出时必须显式转为数组。

常见错误现象：导出 Excel 后全是空白行，或 CSV 文件第一行显示 “App\Model\User Object” 字符串。

正确做法是先调用 toArray()，再导出
若需过滤字段（如隐藏 password、create_time），必须在 toArray() 前链式调用 hidden()、visible() 或 append()
注意：这些方法只对当前模型实例或数据集有效，不能写在导出逻辑之后

示例：$users = User::select()->hidden(['password', 'token'])->append(['status_text'])->toArray();

`append` 字段导出失败？检查方法命名和字段冲突

想导出带格式的金额或状态文本（如 price_format），用了 append(['price_format']) 却没出现在导出结果里，大概率是命名或定义问题。

关键点：

append 数组里的字段名（如 'price_format'）必须严格对应一个 getPriceFormatAttr() 方法（首字母大写，下划线转驼峰）
如果数据库表里已有同名字段 price_format，TP 会优先取数据库值，忽略 getPriceFormatAttr()
getPriceFormatAttr() 方法体内不能直接返回未处理的原始值（如 return $value;），否则和原字段无区别；应做格式化，例如 return number_format($value, 2);

调试建议：dump(User::find(1)->append(['price_format'])->toArray()); 看是否真能拿到值。

PHP

编写健壮的PHP代码，规避类型转换陷阱、数组怪癖及常见安全漏洞。

下载

大数据量导出卡死？别用 `fromArray()` 直接灌入 Spreadsheet

当导出记录超过 5000 行，用 $spreadsheet->getActiveSheet()->fromArray($data) 极易触发内存溢出或超时——因为 PhpSpreadsheet 默认把整张表加载进内存，且每个单元格都是独立对象。

更稳妥的做法是分批写入：

用 foreach 遍历数据，逐行调用 setCellValue()
每写入 1000 行，手动调用 gc_collect_cycles() 触发 PHP 垃圾回收
避免在循环内反复调用 getActiveSheet()，提前存为变量：$sheet = $spreadsheet->getActiveSheet();
导出前禁用公式计算：$spreadsheet->setCalculationEngine(null);

CSV 导出不受此限制，fputcsv() 是流式写入，10 万行也几乎不占内存。

中文乱码、日期变时间戳？导出前统一预处理字段值

从模型导出的日期字段默认是 Carbon 实例，JSON 或 CSV 中可能变成时间戳或报错；中文字段在 Excel 中显示为方块，多因字体或编码未设好。

解决路径很实际：

日期字段不要依赖获取器自动格式化，导出前统一转字符串：'created_at' => $user->created_at?->toDateString()
金额字段用 number_format($v, 2) 而非保留 float，避免 199.999999999 类精度问题
Excel 导出时，PhpSpreadsheet 默认不嵌入中文字体，需手动设置：$sheet->getStyle('A1:Z1000')->getFont()->setName('Microsoft YaHei');
CSV 不涉及字体，但浏览器下载时若用 Excel 打开中文乱码，是因为 Excel 默认用 ANSI 编码读 UTF-8 —— 解决办法是在 CSV 内容开头加 BOM：fprintf($output, "\xEF\xBB\xBF");

最易被忽略的是：BOM 必须在 fputcsv() 任何写入之前插入，且只能写一次。