使用laravel-excel导入电子表格时如何自动处理前置空行空列？

你需要借助laravel-excel提供的扩展接口，分别处理前置空行和首列空值的问题，具体实现如下：

方案1：固定前置3行空、首列空的场景（适配你当前的表格规则） #

步骤1：引入需要的接口 #

在Import类中引入SkipsEmptyRows（自动跳过空行）、WithMapping（自定义行数据映射）接口，同时保留原有的ToModel、WithHeadingRow。

步骤2：指定表头行位置 #

重写headingRow方法，因为前3行是空，表头位于第4行，直接返回行号4即可（laravel-excel行号从1开始计数）。

步骤3：自定义行数据映射 #

在map方法中过滤掉行内的空列（首列空值），重新绑定字段对应关系。

完整代码示例 #

<?php
namespace App\Imports;

use App\Models\User;
use Maatwebsite\Excel\Concerns\ToModel;
use Maatwebsite\Excel\Concerns\WithHeadingRow;
use Maatwebsite\Excel\Concerns\SkipsEmptyRows;
use Maatwebsite\Excel\Concerns\WithMapping;

class UserImport implements ToModel, WithHeadingRow, SkipsEmptyRows, WithMapping
{
    // 指定表头所在行号（前3行空，所以表头在第4行）
    public function headingRow(): int
    {
        return 4;
    }

    // 映射行数据，过滤空列
    public function map($row): array
    {
        // 过滤行内的空值、空键，保留有效数据
        // 注意：如果你的业务允许0值，需要自定义回调避免误删，示例：
        // $validColumns = array_filter($row, fn($value) => !is_null($value) && $value !== '');
        $validColumns = array_values(array_filter($row));
        
        // 按顺序对应表头字段，顺序和你实际表头一致即可
        return [
            'firstname' => $validColumns[0] ?? null,
            'lastname' => $validColumns[1] ?? null,
            'age' => $validColumns[2] ?? null,
            'email' => $validColumns[3] ?? null,
        ];
    }

    /**
    * @param array $row
    *
    * @return \Illuminate\Database\Eloquent\Model|null
    */
    public function model(array $row)
    {
        // 跳过没有邮箱的无效行
        if (empty($row['email'])) {
            return null;
        }
        
        return new User([
            'first_name' => $row['firstname'],
            'last_name' => $row['lastname'],
            'age' => $row['age'],
            'email' => $row['email'],
        ]);
    }
}

方案2：适配不固定空行/空列的通用场景 #

如果部分表格前置空行数量不固定，可以放弃WithHeadingRow接口，手动识别表头行：

<?php
namespace App\Imports;

use App\Models\User;
use Maatwebsite\Excel\Concerns\ToModel;
use Maatwebsite\Excel\Concerns\SkipsEmptyRows;
use Maatwebsite\Excel\Concerns\WithStartRow;

class UserImport implements ToModel, SkipsEmptyRows, WithStartRow
{
    // 存储识别到的表头字段
    protected $headings = [];

    // 从第一行开始遍历，自己识别表头
    public function startRow(): int
    {
        return 1;
    }

    public function model(array $row)
    {
        // 过滤当前行的空列
        $validRow = array_values(array_filter($row));
        
        // 还没识别到表头，判断当前行是不是表头（包含你指定的表头字段比如email）
        if (empty($this->headings)) {
            if (in_array('Email', $validRow) || in_array('email', $validRow)) {
                // 统一转小写作为键名
                $this->headings = array_map('strtolower', $validRow);
            }
            return null;
        }

        // 有效数据长度和表头不匹配，跳过无效行
        if (count($validRow) < count($this->headings)) {
            return null;
        }

        // 组合成键值对
        $rowData = array_combine($this->headings, array_slice($validRow, 0, count($this->headings)));

        return new User([
            'first_name' => $rowData['firstname'] ?? null,
            'last_name' => $rowData['lastname'] ?? null,
            'age' => $rowData['age'] ?? null,
            'email' => $rowData['email'] ?? null,
        ]);
    }
}

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