Laravel实现类似Excel「选择性粘贴-跳过空单元格」合并多CSV

我来帮你搞定这个Laravel里合并CSV的需求——完全复刻Excel「跳过空单元格」的逻辑其实不难，咱们一步步来：

本质上就是以学生唯一标识（比如name字段）为键，遍历所有上传的CSV文件，逐行读取后只保留非空字段，用这些非空值去补全/更新已有的学生记录，空字段直接跳过，绝不覆盖已有非空数据。

1. 选用合适的CSV处理工具 #

相比FastExcel，我更推荐用league/csv这个包——它专门处理CSV，API更灵活，能轻松实现逐行读取和字段处理。先安装它：

composer require league/csv

2. 后端Controller完整代码 #

假设前端用的是多文件上传控件（name属性设为csv_files[]），咱们在Controller里写处理逻辑：

<?php

namespace App\Http\Controllers;

use Illuminate\Http\Request;
use League\Csv\Reader;
use League\Csv\Writer;

class CsvMergeController extends Controller
{
    public function mergeCsvs(Request $request)
    {
        // 验证上传文件：必须是CSV，最多15个（对应你的机器数量）
        $request->validate([
            'csv_files.*' => 'required|mimes:csv,txt|max:2048',
        ]);

        // 初始化存储合并结果的数组，key是学生name，value是完整记录
        $mergedRecords = [];

        // 遍历每个上传的CSV文件
        foreach ($request->file('csv_files') as $csvFile) {
            // 打开CSV文件，设置表头（假设每个CSV的列结构完全一致）
            $csv = Reader::createFromPath($csvFile->getRealPath(), 'r');
            $csv->setHeaderOffset(0); // 第一行是表头

            // 逐行读取CSV记录
            foreach ($csv->getRecords() as $record) {
                $studentName = $record['name'];
                
                // 如果该学生还没有记录，直接初始化
                if (!isset($mergedRecords[$studentName])) {
                    $mergedRecords[$studentName] = $record;
                    continue;
                }

                // 核心逻辑：只保留非空字段，更新已有记录
                foreach ($record as $key => $value) {
                    // 跳过空值，只更新非空的字段
                    if (!empty(trim($value))) {
                        $mergedRecords[$studentName][$key] = $value;
                    }
                }
            }
        }

        // 把合并后的数组转换成二维数组（去掉name作为key的结构）
        $finalData = array_values($mergedRecords);

        // 可选：导出合并后的CSV给前端下载
        $writer = Writer::createFromString('');
        $writer->insertOne(array_keys(reset($finalData))); // 写入表头
        $writer->insertAll($finalData); // 写入所有记录

        return response($writer->getContent())
            ->header('Content-Type', 'text/csv')
            ->header('Content-Disposition', 'attachment; filename="merged_student_scores.csv"');

        // 如果你要存数据库，这里可以循环$finalData，用Eloquent模型批量插入/更新
        // foreach ($finalData as $data) {
        //     StudentScore::updateOrCreate(['name' => $data['name']], $data);
        // }
        // return redirect()->back()->with('success', '数据合并完成！');
    }
}

3. 关键逻辑解析 #

• 文件验证：确保上传的都是合法的CSV文件，数量符合你的机器数（10-15台）。
• 记录存储结构：用name作为数组键，能快速定位到对应学生的记录，避免重复遍历。
• 跳过空单元格：通过!empty(trim($value))判断，只把非空的字段值更新到已有记录里——完全对应Excel的「跳过空单元格」功能。
• 导出/存储：最后可以选择导出CSV给用户，或者直接把合并后的数据存入数据库，按需调整即可。

额外注意事项 #

• 确保所有CSV的列结构完全一致（表头字段名相同），否则会出现字段不匹配的问题。
• 如果name不是唯一标识，可以换成学号（比如student_id），只要是每个学生独有的字段就行。
• 大文件处理：如果CSV文件很大，可以用league/csv的流式读取，避免内存溢出——不过你的场景是10-15台机器的记录，应该不会有太大问题。

内容的提问来源于stack exchange，提问作者maximus1127