贝利信息

Laravel Excel 导出多维数组数据的正确处理方法

日期:2026-01-22 00:00 / 作者:聖光之護

laravel 使用 phpspreadsheet 或 laravel excel 导出时,若传递关联数组(如 `["att_cross" => $data1, "belum_absen" => $data2]`)会报错“call to a member function all() on array”,因其期望接收集合(collection)或可迭代对象,而非原生数组。

在 Laravel Excel(如 maatwebsite/excel v3.x/v4.x)中,Excel::download() 接收的导出类(如 ReportExport)必须实现 FromCollection、FromArray 或 FromQuery 等契约接口,且其 collection() 或 array() 方法必须返回单一可遍历结构(如 Collection 或二维数值数组),不支持直接返回关联键名的多维数组

你当前的 ReportExport 类中返回了关联数组:

return [
    "att_cross" => $att_cross,
    "belum_absen" => $belum_absen,
    "absen" => $absen,
];

这会导致 Excel 包在内部调用 $data->all()(仅 Collection 有该方法)时失败——因为 PHP 数组没有 all(

) 方法。

✅ 正确做法是:将多个数据集合并为一张表,或分页/分 Sheet 导出。推荐两种主流方案:

方案一:合并为单表(适合数据结构一致)

若 $absen、$belum_absen、$att_cross 均为同构数组(如都含 name, date, status 字段),可合并后导出:

// ReportExport.php
use Maatwebsite\Excel\Concerns\FromCollection;

class ReportExport implements FromCollection
{
    protected $absen;
    protected $belumAbsen;
    protected $attCross;

    public function __construct($request)
    {
        // 假设你已在构造中赋值这些变量
        $this->absen = $request->absen ?? [];
        $this->belumAbsen = $request->belum_absen ?? [];
        $this->attCross = $request->att_cross ?? [];
    }

    public function collection()
    {
        // 合并并添加来源标识(便于区分)
        $merged = collect($this->absen)
            ->map(fn($row) => array_merge($row, ['source' => 'absen']))
            ->concat(collect($this->belumAbsen)->map(fn($row) => array_merge($row, ['source' => 'belum_absen'])))
            ->concat(collect($this->attCross)->map(fn($row) => array_merge($row, ['source' => 'att_cross'])));

        return $merged;
    }
}

方案二:分 Sheet 导出(推荐,结构清晰)

使用 WithMultipleSheets 接口,为每组数据创建独立工作表:

// ReportExport.php
use Maatwebsite\Excel\Concerns\FromCollection;
use Maatwebsite\Excel\Concerns\WithMultipleSheets;
use Maatwebsite\Excel\Concerns\WithTitle;

class ReportExport implements WithMultipleSheets
{
    protected $absen;
    protected $belumAbsen;
    protected $attCross;

    public function __construct($request)
    {
        $this->absen = $request->absen ?? [];
        $this->belumAbsen = $request->belum_absen ?? [];
        $this->attCross = $request->att_cross ?? [];
    }

    public function sheets(): array
    {
        return [
            'Absen' => new class($this->absen) implements FromCollection, WithTitle {
                protected $data;
                public function __construct($data) { $this->data = $data; }
                public function collection() { return collect($this->data); }
                public function title(): string { return 'Absen'; }
            },
            'Belum Absen' => new class($this->belumAbsen) implements FromCollection, WithTitle {
                protected $data;
                public function __construct($data) { $this->data = $data; }
                public function collection() { return collect($this->data); }
                public function title(): string { return 'Belum Absen'; }
            },
            'Cross Check' => new class($this->attCross) implements FromCollection, WithTitle {
                protected $data;
                public function __construct($data) { $this->data = $data; }
                public function collection() { return collect($this->data); }
                public function title(): string { return 'Cross Check'; }
            },
        ];
    }
}

⚠️ 注意事项:

通过以上任一方式,即可规避 Call to a member function all() on array 错误,并专业、清晰地导出多维度考勤数据。