Laravel Excel 导入时按工作表名称动态关联数据的完整实现-php教程-PHP中文网

Laravel Excel 导入时按工作表名称动态关联数据的完整实现

本文详解如何在 laravel excel 导入过程中，正确遍历 excel 多工作表，将每个工作表的名称（如 'banana'、'strawberry'）作为字段写入数据库，避免重复插入或仅取首表名的问题。

本文详解如何在 laravel excel 导入过程中，正确遍历 excel 多工作表，将每个工作表的名称（如 'banana'、'strawberry'）作为字段写入数据库，避免重复插入或仅取首表名的问题。

在使用 Laravel Excel（基于 PhpSpreadsheet）处理多工作表 Excel 文件时，一个常见需求是：每张工作表代表一类产品（如 banana 表存放香蕉数据，strawberry 表存放草莓数据），导入时需将工作表名称自动映射为数据库中的 product 字段值。但原始代码中嵌套循环顺序错误（先遍历行、再遍历表名），导致每行数据被重复插入 N 次，且所有记录的 product 值均来自同一张表（实际是内层循环末次赋值覆盖所致）。

✅ 正确逻辑：先按工作表分组，再逐表读取数据

核心原则是：以工作表为单位进行处理。不应预先加载全部工作表名后与行数据做笛卡尔积，而应——

使用 PhpOffice\PhpSpreadsheet\IOFactory 加载文件；
获取所有工作表名；
遍历每个工作表 → 读取其独立数据 → 批量写入对应 product 名称。

以下是重构后的 ProductImport 类实现（兼容 Laravel Excel v3+，适用于 Artisan 命令）：

<?php namespace App\Imports;

use PhpOffice\PhpSpreadsheet\IOFactory;
use PhpOffice\PhpSpreadsheet\Worksheet\Worksheet;
use Illuminate\Support\Collection;
use Maatwebsite\Excel\Concerns\ToCollection;
use Maatwebsite\Excel\Concerns\WithProgressBar;
use Maatwebsite\Excel\Concerns\WithHeadingRow;
use Maatwebsite\Excel\Concerns\Importable;
use App\Models\Product; // 假设模型名为 Product

class ProductImport implements ToCollection, WithHeadingRow, WithProgressBar
{
    use Importable;

    protected $inputFileName;

    public function __construct(string $inputFileName = null)
    {
        $this->inputFileName = $inputFileName ?? storage_path('app/fruit/listFruit.xlsx');
    }

    public function collection(Collection $rows)
    {
        // ❌ 错误：不在此处读取全局 rows！它只反映第一个工作表（默认行为）
        // ✅ 正确：绕过 Laravel Excel 默认行读取，直接用 PhpSpreadsheet 控制工作表遍历
        $reader = IOFactory::createReader('Xlsx');
        $reader->setReadDataOnly(true);
        $spreadsheet = $reader->load($this->inputFileName);
        $sheetNames = $spreadsheet->getSheetNames();

        foreach ($sheetNames as $sheetIndex => $sheetName) {
            $sheet = $spreadsheet->getSheet($sheetIndex);
            // 读取当前工作表全部数据（跳过标题行）
            $sheetData = $sheet->toArray(null, true, true, true);

            // 跳过空表或无数据表
            if (empty($sheetData) || count($sheetData)  $sheetName];

                Product::updateOrCreate(
                    [
                        'price' => $data['price'] ?? null,
                        'size' => $data['size'] ?? null,
                        'product' => $sheetName, // 关键：固定为当前表名
                    ],
                    [
                        'price' => $data['price'] ?? null,
                        'size' => $data['size'] ?? null,
                        // 其他字段...
                    ]
                );
            }
        }
    }
}

? Artisan 命令调用优化

更新 UploadProduct 命令，显式传入文件路径并启用进度条：

excel-deduplicate

辅助处理excel表格，去重——先查重再删除重复行

下载

// app/Console/Commands/UploadProduct.php
public function handle()
{
    $this->output->title('Starting multi-sheet product import');

    $filePath = storage_path('app/fruit/listFruit.xlsx');
    if (!file_exists($filePath)) {
        $this->error("Excel file not found: {$filePath}");
        return 1;
    }

    (new ProductImport($filePath))
        ->withOutput($this->output)
        ->import($filePath);

    $this->output->success('✅ Import completed successfully for all sheets.');
}

⚠️ 关键注意事项

不要混合 Laravel Excel 的 collection() 回调与手动 PhpSpreadsheet 加载：原代码中 collection($rows) 的 $rows 仅来自首个工作表，后续手动加载全表属于冗余且易错操作。应完全放弃 $rows 参数，专注用 PhpSpreadsheet 精确控制多表读取。
工作表索引 vs 名称：$spreadsheet->getSheet($index) 比 getSheetByName($name) 更可靠，避免名称含空格/特殊字符时匹配失败。
内存优化：对超大 Excel，建议使用 ChunkReading 或流式读取（WithChunkReading），但需配合自定义 Reader 实现。
数据清洗：示例中已加入空行跳过、标题小写统一等健壮性处理，生产环境应补充字段验证（如 price 必须为数字）。