laravel怎么导出CSV或Excel文件_laravel CSV/Excel文件导出方法

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']);。

巧文书

巧文书是一款AI写标书、AI写方案的产品。通过自研的先进AI大模型，精准解析招标文件，智能生成投标内容。

61

查看详情

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() 启动下载流程，样式将自动应用。

以上就是laravel怎么导出CSV或Excel文件_laravel CSV/Excel文件导出方法的详细内容，更多请关注php中文网其它相关文章！