如何在表头位于自定义单元格时使用Laravel Excel导入数据？

刚好碰到过类似的需求，Laravel Excel其实提供了很灵活的配置来处理这种非默认位置的表头，给你针对场景的具体解决方案：

针对表头在B2这类自定义单元格的处理 #

你需要同时用到WithStartCell和WithHeadingRow两个接口，前者用来指定数据读取的起始单元格，后者明确表头所在的行号。修改后的代码如下：

namespace App\Imports;
use App\Mhs;
use Illuminate\Support\Collection;
use Maatwebsite\Excel\Concerns\ToCollection;
use Maatwebsite\Excel\Concerns\WithHeadingRow;
use Maatwebsite\Excel\Concerns\WithStartCell; // 引入新接口

class MhsImport implements ToCollection, WithHeadingRow, WithStartCell {
    // 指定读取的起始单元格为B2
    public function startCell(): string
    {
        return 'B2';
    }

    // 声明表头所在的行号（B2属于第2行）
    public function headingRow(): int
    {
        return 2;
    }

    public function collection(Collection $rows) {
        foreach ($rows as $row) {
            if ($row->filter()->isNotEmpty()) {
                $mhs = Mhs::create([
                    'nim' => $row['nim'], // 这里的键要和B2、C2等单元格的表头文本完全匹配
                    'nama' => $row['nama'],
                    'jurusan' => $row['jurusan']
                ]);
            }
        }
    }
}

关键细节说明 #

• WithStartCell：告诉Laravel Excel从B2开始处理数据，自动忽略A1、A2这些前面的单元格，避免读取到无关内容。
• headingRow()：因为你的表头在第2行，所以返回2。如果表头在其他行（比如B3），就对应修改这个数字即可。
• 表头匹配：要确保$row['xxx']里的键和你Excel中B2、C2等位置的表头文本完全一致，大小写是敏感的，如果出现找不到键的错误，先检查这个匹配度。

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