laravel中可采用四种轻量csv导出方案：一、stream()流式输出，避免内存溢出；二、stringable+streamedresponse构造纯字符串csv；三、临时文件+readfile输出，便于调试；四、封装exportservice类复用逻辑。
如果您需要在Laravel应用中将数据库查询结果快速导出为CSV文件，且不希望引入大型第三方包或复杂配置，则可采用原生PHP流式输出结合Laravel查询构建器的轻量方案。以下是实现此功能的具体步骤：
一、使用response()->stream()直接输出CSV流
该方法绕过内存缓冲，逐行写入CSV内容，避免大结果集导致的内存溢出，适合中等数据量导出。核心是利用fputcsv函数配合PHP输出流，由Laravel响应对象接管HTTP头设置。
1、在控制器中定义导出方法，例如exportUsersCsv；
2、调用DB::table()或Eloquent模型获取查询生成器，不执行get()，保留为Builder实例；
3、使用response()->stream()包裹匿名函数，在函数内打开php://output流；
4、手动写入CSV头部行，使用fputcsv($fp, ['ID', '姓名', '邮箱'])；
5、通过chunk(500)分块遍历结果，对每批数据调用fputcsv写入对应字段值；
6、在响应头中设置Content-Type为text/csv，Content-Disposition为attachment; filename="users.csv"。
二、基于Stringable与StreamedResponse构造纯字符串CSV
该方式适用于数据量较小（如千行以内）、需完全控制字段格式（如含逗号、换行符）的场景。先构建完整CSV字符串再流式返回，避免fputcsv自动转义带来的不可控性。
1、使用collect()加载全部数据，映射为二维数组，确保每行字段顺序一致；
2、对每个字段值执行str_replace(["\n", "\r", ","], " ", $value)做基础清洗；
3、用array_map和implode(",", ...)拼接每行，再用implode("\n")连接所有行；
4、将最终字符串传入StreamedResponse::create()，并手动设置headers；
5、在回调中echo $csvContent，不使用return；
6、确保控制器方法返回该StreamedResponse实例。
三、借助临时内存文件配合readfile输出
此方法在临时目录生成一个真实CSV文件，再通过readfile强制输出并删除，兼顾可调试性与低内存占用，适合需日志记录或异常捕获的部署环境。
1、调用sys_get_temp_dir()获取系统临时路径；
2、生成唯一文件名，例如sprintf('%s/export_%s.csv', $tempDir, uniqid())；
3、使用fopen($filePath, 'w')打开文件，fwrite写入BOM头"\xEF\xBB\xBF"以支持Excel中文识别；
4、逐块写入数据，每行调用fputcsv；
5、关闭文件句柄后，设置响应头为Content-Type: text/csv；
6、调用readfile($filePath)，随后unlink($filePath)立即删除临时文件。
四、封装为可复用的ExportService类
将CSV导出逻辑抽离为独立服务类，便于在多个控制器复用，并统一处理编码、BOM、字段映射等细节，同时隔离业务查询与导出格式。
1、创建app/Services/ExportService.php，定义public function toCsv($queryBuilder, array $columns, string $filename)；
2、在方法内判断$columns是否为空，若为空则从$queryBuilder->toSql()预估字段或抛出InvalidArgumentException；
3、使用Generator yield逐行产出数据，避免全量加载；
4、在yield前统一将字符串字段转为UTF-8编码，防止乱码；
5、构造StreamedResponse时注入该Generator作为回调参数；
6、控制器中仅需调用(new ExportService)->toCsv(User::query(), ['id','name','email'], 'users.csv')。
