Laravel项目中Laravel-excel多行表头导入数据的实现方法

针对你遇到的表头分布在第3、4行的情况，可通过自定义导入类实现数据映射，以下是具体实现步骤：

1. 创建自定义导入类 #

在项目中生成导入类（比如app/Imports/MultiHeaderExcelImport.php），核心思路是手动读取两行表头，再将后续数据行与表头字段对应：

<?php

namespace App\Imports;

use Maatwebsite\Excel\Concerns\ToCollection;
use Maatwebsite\Excel\Concerns\WithStartRow;
use Maatwebsite\Excel\Concerns\WithEvents;
use Maatwebsite\Excel\Events\BeforeImport;
use Illuminate\Support\Collection;

class MultiHeaderExcelImport implements ToCollection, WithStartRow, WithEvents
{
    // 存储合并后的完整表头字段
    private $headers = [];

    // 指定数据起始行（第5行，跳过前4行的表头内容）
    public function startRow(): int
    {
        return 5;
    }

    // 导入前读取两行表头
    public function registerEvents(): array
    {
        return [
            BeforeImport::class => function(BeforeImport $event) {
                $worksheet = $event->reader->getActiveSheet();

                // 读取第3行的表头（A-C列）
                $row3Headers = $worksheet->rangeToArray('A3:C3', null, true, true, true)[3];
                // 读取第4行的表头（D-G列）
                $row4Headers = $worksheet->rangeToArray('D4:G4', null, true, true, true)[4];

                // 合并两行表头为一个数组
                $this->headers = array_merge(
                    array_values($row3Headers),
                    array_values($row4Headers)
                );
            },
        ];
    }

    // 处理数据行，映射到表头字段
    public function collection(Collection $rows)
    {
        foreach ($rows as $row) {
            // 将数据行转为关联数组，键为表头字段
            $data = array_combine($this->headers, $row->toArray());

            // 此处可添加数据处理逻辑，比如存入数据库
            // ExampleModel::create($data);
        }
    }
}

2. 关键逻辑说明 #

• WithStartRow：指定从第5行开始读取数据，自动跳过前4行的表头内容。
• BeforeImport事件：在正式导入数据前，主动读取第3、4行的表头内容，合并为完整的表头数组。
• collection方法：通过array_combine将数据行与表头关联，得到以表头字段为键的关联数组，方便后续业务处理。

3. 调用导入类 #

在控制器或自定义命令中调用该导入类即可：

use App\Imports\MultiHeaderExcelImport;
use Maatwebsite\Excel\Facades\Excel;

// 示例调用
Excel::import(new MultiHeaderExcelImport, 'your-excel-file.xlsx');

4. 注意事项 #

• 需根据实际Excel文件的列范围调整rangeToArray的参数，确保表头读取准确。
• 如果存在表头单元格合并的情况，需额外通过$worksheet->getMergeCells()获取合并信息，再解析对应表头内容。

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