laravel 提供多种方式导出数据，推荐使用 laravel-excel 扩展包实现 excel 文件导出，支持样式定制与大数据优化；也可手动构建 csv 响应流，结合查询构造器的 cursor 或 chunk 方法分批处理，避免内存溢出，适用于报表生成与数据备份场景。
如果您需要将数据库中的数据以结构化文件形式提供给用户下载，例如生成报表或备份数据，Laravel 提供了多种方式来实现 CSV 或 Excel 文件的导出功能。以下是几种常见的实现方法：
本文运行环境：MacBook Pro，macOS Sonoma
一、使用 Laravel-Excel 扩展包导出 Excel 文件
Laravel-Excel 是基于 PhpSpreadsheet 的强大扩展包，能够简化 Excel 文件的创建和导出过程，支持 .xlsx 和 .xls 格式。
1、在项目根目录下通过 Composer 安装 Laravel-Excel 包：composer require maatwebsite/excel。
2、发布配置文件以便自定义设置：php artisan vendor:publish --provider="Maatwebsite\Excel\ExcelServiceProvider"。
3、创建一个导出类，例如用于导出用户数据：php artisan make:export UsersExport --model=User。
4、在生成的 UsersExport 类中实现 FromCollection 接口，并在 collection() 方法中返回要导出的数据集合。
5、在控制器中调用该导出类，使用 Excel::download() 方法触发文件下载：return Excel::download(new UsersExport, 'users.xlsx');。
二、手动构建 CSV 文件响应
对于简单的 CSV 导出需求，可以直接使用 PHP 的 fputcsv 函数结合 Laravel 的响应流机制生成文件，无需额外依赖。
1、在控制器中定义一个导出方法，设置正确的 HTTP 响应头以指示浏览器下载文件。
2、使用 response()->stream() 返回一个流式响应，避免内存溢出处理大量数据。
3、在闭包内部打开输出句柄，写入 UTF-8 BOM（防止中文乱码）和表头字段。
4、从数据库获取数据并逐行写入 CSV，示例代码如下：fputcsv($handle, ['ID', 'Name', 'Email']);。
5、每处理一批数据后清空输出缓冲区，保持低内存占用。
三、结合查询构造器优化大数据量导出
当导出记录数较大时，应避免一次性加载所有数据到内存，可通过游标或分块查询提升性能。
1、使用 cursor() 方法遍历 Eloquent 模型，它会利用生成器逐条读取数据。
2、在 stream 下载闭包中循环 cursor 结果，并将每条记录格式化后写入 CSV 句柄。
3、对于更复杂的查询场景，可使用 chunk() 方法按指定数量分批提取数据。
4、在每个数据块处理完成后调用 GC 清理内存：gc_collect_cycles();。
四、使用 Laravel-Excel 自定义导出样式
除了基本数据导出，Laravel-Excel 还支持对 Excel 文件进行样式定制，如设置列宽、字体、背景色等。
1、在导出类中引入 WithStyles、WithColumnWidths 等接口，并实现对应方法。
2、通过 styles() 方法返回一个数组定义行或列的样式规则。
3、使用 WithHeadingRow 接口确保第一行为表头。
4、若需冻结窗格，可在 registerEvents 中使用 AfterSheet 事件调用 setFreezePane()。
5、最终仍通过 Excel::download() 启动下载流程，样式将自动应用。
