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

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

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 字段),可合并后导出:

智慧车行预约小程序

智慧车行预约小程序

智慧车行小程序,是一个专门为洗车/4S/车辆维修行业打造的小程序,前后端完整代码包括车行动态,养车常识,保养预约,维修预约,洗车美容预约,汽车检测预约等功能。采用腾讯提供的小程序云开发解决方案,无须服务器和域名预约管理:开始/截止时间/人数均可灵活设置,可以自定义客户预约填写的数据项预约凭证:支持线下到场后校验签到/核销/二维码自助签到等多种方式详尽的预约数据:支持预约名单数据导出Excel,打印

下载

// 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'; }
            },
        ];
    }
}

⚠️ 注意事项:

  • 确保 maatwebsite/excel 版本 ≥ 3.1(v4.x 同样适用,接口一致);
  • 所有数据需为数组或可转为 Collection 的结构(如 Eloquent 模型、array_map 处理后的数组);
  • 若原始数据是 stdClass 对象或关联数组,用 collect($data) 包裹即可安全转换;
  • 不要试图在 collection() 中返回关联数组(如 [‘key’ => $value]),必须返回扁平化二维结构(如 [[‘col1’=>’a’,’col2’=>’b’], …])。

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

https://www.php.cn/faq/2017923.html

发表回复

Your email address will not be published. Required fields are marked *