box/spout是唯一能稳定用3MB内存处理百万行CSV/XLSX的方案；phpspreadsheet和maatwebsite/excel因全量加载易致内存爆满，应避免使用。
直接装 box/spout 就行，别碰 phpoffice/phpspreadsheet 或 maatwebsite/excel
如果你的目标是读写百万行 CSV/XLSX 且不爆内存，box/spout 是当前唯一能稳压 3MB 内存跑完的方案；而 phpspreadsheet 默认全量加载，10 万行就可能吃掉 500MB+，maatwebsite/excel 只是它的 Laravel 封装，底层没换——装了反而更重。
常见错误现象：composer require maatwebsite/excel 后导出卡死、超时、内存耗尽；或报 Class 'Maatwebsite\Excel\ExcelServiceProvider' not found（漏装 Laravel 或版本不匹配）。
-
composer require box/spout即可，无需额外插件或服务提供者 - PHP 5.6 老项目？用
box/spout:v2.7.3（v3+ 要求 PHP ≥ 7.4） - 手动安装不可取：自动加载路径容易错，
autoload.php位置一偏就报Class not found
WriterEntityFactory::createCSVWriter() 和 WriterFactory::create(Type::CSV) 有啥区别？
这是 Spout v2 和 v3 的 API 断层点，混用会报 Call to undefined method。v2（如老项目用的 v2.7.3）必须用 WriterFactory + Type::CSV；v3+ 统一改用 WriterEntityFactory。
使用场景：Laravel 5.4 + PHP 5.6 → 锁死 v2.7.3；新项目（PHP ≥ 7.4）直接上 v4（2026 年最新稳定版），API 更一致。
- v2 示例：
$writer = WriterFactory::create(Type::CSV); $writer->openToFile('out.csv'); - v3/v4 示例：
$writer = WriterEntityFactory::createCSVWriter(); $writer->openToFile('out.csv'); - 别在 v2 里硬套 v3 的命名空间，
Box\Spout\Writer\Common\Creator\WriterEntityFactory在 v2 中根本不存在
数据库导出卡在“查得出来，写不进去”？多半是没分页 + 没关 Eloquent 模型加载
Spout 本身不加载 ORM，但很多人写 DB::table('orders')->get() 或 Order::all()，结果整张表（几百万行）先塞进内存，Spout 还没开始写就 OOM 了。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
性能影响：单次 get() 查 100 万行，PHP 进程常驻内存飙升至 800MB+；用分页后稳定在 12MB 左右（Spout 流式写入 + 数据库游标驱动）。
- 必须用
forPage($page, $pageSize)或chunk(1000)，$pageSize = 1000是实测较稳的阈值 - Laravel 中避免
Order::with('user')—— 关联预加载会指数级放大内存占用 - 记得把
(array) $record强转，否则createRowFromArray()会报Array to string conversion
$writer->openToBrowser() 下载失败？header 冲突和缓冲区是隐形杀手
Spout 的 openToBrowser() 本质是输出 header + 流式 body，一旦前面有 echo、var_dump、日志写入、甚至空格/UTF-8 BOM，就会触发 Cannot modify header information。
兼容性影响：部分 Nginx 配置（如 fastcgi_buffering on）会截断流式响应，导致 Excel 打开报“文件损坏”；Apache 一般更友好。
- 确保控制器方法是第一个执行逻辑，前面无任何输出（包括 config 文件里的
?>结尾空格） - 下载前加
ob_end_clean();清空输出缓冲（尤其用了 Log::info 等框架日志） - 临时文件夹权限不足也会静默失败：用
$writer->setTempFolder('/tmp/spout');显式指定并chmod 755 /tmp/spout
真正难的不是调哪个函数，而是从“查全量再导出”的思维里跳出来——Spout 不是 Excel 处理器，它是数据管道。只要中间任何一环（查询、转换、输出）把数据攒起来，3MB 承诺就立刻失效。
