Laravel Excel 导出：从多个关联表获取数据-php教程-PHP中文网

Laravel Excel 导出：从多个关联表获取数据

DDD

发布： 2025-09-29 17:16:11

原创

199人浏览过

laravel excel 导出：从多个关联表获取数据

本文旨在指导开发者在使用 Laravel Excel 导出数据时，如何从多个关联表中获取数据，并展示如何将关联表中的字段（例如用户名）导出到 Excel 文件中。文章将通过示例代码，详细解释如何配置 Eloquent 模型关系，并在导出类中正确引用这些关系，最终实现数据的完整导出。

导出关联数据

在 Laravel 项目中，经常需要将多个表的数据导出到 Excel 文件中。如果这些表之间存在关联关系，例如一对多关系，我们需要在导出时正确地处理这些关系，才能获得完整的数据。

假设我们有两个表：accessory_requests（配件请求表）和 accessory_details（配件详情表）。一个配件请求可以对应多个配件详情。我们的目标是将配件请求表和配件详情表的数据一起导出。

1. 定义 Eloquent 模型关系

首先，确保在 Eloquent 模型中定义了正确的关系。在 AccessoryRequest 模型中，已经定义了与 AccessoryRequestDetail 模型的一对多关系：

<?php

namespace App;

use Illuminate\Database\Eloquent\Model;

class AccessoryRequest extends Model
{
   protected $fillable = ['user_id', 'store_id', 'request_date', 'status'];

   public function user() {
       return $this->belongsTo('App\User', 'user_id');
   }

   public function store() {
       return $this->belongsTo('App\Store', 'store_id');
   }

   public function details() {
       return $this->hasMany('App\AccessoryRequestDetail');
   }
   public function vendor() {
       return $this->belongsTo('App\AccessoryVendor', 'vendor_id');
   }

}

登录后复制

2. 修改导出类

接下来，修改 AccessoryRequestExport 类，以便能够导出关联数据。关键在于如何在 collection 方法中加载关联关系，并在 headings 方法和数据处理中正确引用这些关系。

<?php

namespace App\Exports;

use App\AccessoryRequest;
use Maatwebsite\Excel\Concerns\FromCollection;
use Maatwebsite\Excel\Concerns\WithHeadings;

class AccessoryRequestExport implements FromCollection, WithHeadings
{
    public function collection()
    {
        return AccessoryRequest::with('details', 'user')->get();
    }

    public function headings(): array
    {
        return [
            '请求ID',
            '用户ID',
            '用户名',
            '店铺ID',
            '请求日期',
            '状态',
            '创建时间',
            '更新时间',
            '配件详情ID',
            '供应商ID',
            '条形码',
            '描述',
            '数量',
            '配件详情状态'
        ];
    }

    public function map($accessoryRequest): array
    {
        $details = $accessoryRequest->details->first(); // 获取第一个配件详情，如果需要导出所有详情，需要循环处理

        return [
            $accessoryRequest->id,
            $accessoryRequest->user_id,
            $accessoryRequest->user->name ?? '', // 获取用户名
            $accessoryRequest->store_id,
            $accessoryRequest->request_date,
            $accessoryRequest->status,
            $accessoryRequest->created_at,
            $accessoryRequest->updated_at,
            $details->id ?? '', // 配件详情ID
            $details->vendor_id ?? '',
            $details->barcode ?? '',
            $details->description ?? '',
            $details->qty ?? '',
            $details->status ?? ''
        ];
    }
}

登录后复制

关键点：

酷表ChatExcel

北大团队开发的通过聊天来操作Excel表格的AI工具

查看详情

加载关联关系： 在 collection 方法中使用 AccessoryRequest::with('details', 'user')-youjiankuohaophpcnget() 加载 details 和 user 关系。
获取关联数据： 在 map 方法中，通过 $accessoryRequest->details 获取配件详情数据，通过 $accessoryRequest->user->name 获取用户名。这里使用了 ?? '' 空合并运算符，以避免当关联数据不存在时出现错误。
处理一对多关系： 由于一个配件请求可以对应多个配件详情，示例代码中只获取了第一个配件详情 ($accessoryRequest->details->first())。如果需要导出所有配件详情，则需要在 map 方法中循环处理 $accessoryRequest->details。
添加 map 方法: 为了能够访问到每一个AccessoryRequest 对象，需要实现 Maatwebsite\Excel\Concerns\WithMapping 接口，并添加 map 方法，将数据映射到数组中。

3. 导出用户名字段

为了导出 user_id 对应的用户名，需要先在 AccessoryRequest 模型中定义与 User 模型的关系：

public function user() {
    return $this->belongsTo('App\User', 'user_id');
}

登录后复制

然后在 AccessoryRequestExport 类的 headings 方法中添加 "用户名" 字段，并在 map 方法中使用 $accessoryRequest->user->name 获取用户名。如果用户不存在，则显示空字符串。

4. 总结

通过以上步骤，我们可以成功地从多个关联表中导出数据，并将关联表中的字段（例如用户名）导出到 Excel 文件中。在实际应用中，需要根据具体的模型关系和数据结构，调整代码。例如，如果需要导出所有配件详情，则需要在 map 方法中循环处理 $accessoryRequest->details，并将每个配件详情的数据添加到导出的 Excel 表格中。

注意事项：