Laravel Excel 导入时根据工作表名称自动关联数据-php教程-PHP中文网

Laravel Excel 导入时根据工作表名称自动关联数据

本文详解如何在 Laravel 中使用 Laravel Excel 和 PhpSpreadsheet，按 Excel 多工作表结构导入数据，并将每张工作表的名称（如 banana、strawberry）作为字段写入数据库，避免所有记录误填为同一张表名。

本文详解如何在 laravel 中使用 laravel excel 和 phpspreadsheet，按 excel 多工作表结构导入数据，并将每张工作表的名称（如 `banana`、`strawberry`）作为字段写入数据库，避免所有记录误填为同一张表名。

在使用 Laravel Excel 进行多工作表（Sheet）导入时，一个常见误区是：在 collection() 方法中错误嵌套循环顺序，导致所有行数据都被重复写入并绑定到第一个工作表名。核心问题在于：你当前的逻辑是「对每一行 → 遍历所有 Sheet 名」，这会为单行生成 N 条记录（N = Sheet 数量），且 updateOrCreate 无法区分来源 Sheet。

✅ 正确逻辑应是：先遍历每个 Sheet → 再读取该 Sheet 的全部数据行 → 批量写入，且每条记录携带当前 Sheet 名。

以下是优化后的完整实现方案（兼容 Laravel Excel v3.1+ 及 PhpSpreadsheet）：

Excel XLSX Formula Cleanup

诊断并修复涉及公式、命名范围、Power Query 刷新、数据透视表、VBA/宏保存等问题的 Microsoft Excel XLSX 工作簿

下载

✅ 正确做法：按 Sheet 分层处理数据

<?php namespace App\Imports;

use App\Models\Product;
use Illuminate\Support\Collection;
use Maatwebsite\Excel\Concerns\Importable;
use Maatwebsite\Excel\Concerns\WithProgressBar;
use Maatwebsite\Excel\Concerns\ToCollection;
use PhpOffice\PhpSpreadsheet\IOFactory;

class ProductImport implements ToCollection, WithProgressBar
{
    use Importable;

    public function collection(Collection $rows)
    {
        // ❌ 不要在此处重新加载文件！$rows 是默认第一个 Sheet 的数据（干扰源）
        // ✅ 改为：手动加载整个 Excel，按 Sheet 逐个解析
        $filePath = storage_path('app/fruit/listFruit.xlsx');

        $reader = IOFactory::createReader('Xlsx');
        $reader->setReadDataOnly(true);
        $spreadsheet = $reader->load($filePath);

        $sheetNames = $spreadsheet->getSheetNames();

        foreach ($sheetNames as $sheetName) {
            // 获取当前 Sheet 对象
            $sheet = $spreadsheet->getSheetByName($sheetName);
            if (!$sheet) continue;

            // 转为二维数组（跳过标题行，保留键名映射）
            $data = $sheet->toArray(null, true, true, true);

            // 假设第 1 行是标题（header），从第 2 行开始为数据
            $headers = array_shift($data); // 提取表头
            if (empty($headers)) continue;

            // 将每行数据与表头映射为关联数组
            $mappedRows = [];
            foreach ($data as $row) {
                $mappedRows[] = array_combine($headers, $row) ?: [];
            }

            // 批量插入或更新，每条记录绑定当前 sheetName（即 product 名）
            foreach ($mappedRows as $row) {
                if (empty($row['price']) || empty($row['size'])) {
                    continue; // 跳过空行
                }

                Product::updateOrCreate(
                    [
                        'price' => $row['price'],
                        'size'  => $row['size'],
                        // ✅ 关键：此处绑定的是当前 Sheet 名，非固定值
                        'product' => $sheetName,
                    ],
                    [
                        'price' => $row['price'],
                        'size'  => $row['size'],
                        'product' => $sheetName,
                    ]
                );
            }
        }
    }
}

⚠️ 注意事项与最佳实践

不要混用 Laravel Excel 自动解析与 PhpSpreadsheet 手动解析：原代码中 $rows 是 Laravel Excel 默认读取的第一个 Sheet 数据，而你又手动加载了整个文件——这会造成逻辑冲突和性能浪费。应完全弃用 $rows 参数，改由 IOFactory 统一控制读取。
Sheet 名即业务标识：确保 Excel 中每个 Sheet 名（如 banana）与数据库 product 字段语义一致，且符合唯一性约束（如需 unique:products,product 验证，请在 Model 中配置）。
内存与性能：若 Sheet 数据量极大（>10,000 行），建议改用 WithChunkReading + 手动分块读取，或使用 DB::transaction() + upsert() 提升效率。

错误处理增强（推荐补充）：

try {
    // ... 上述导入逻辑
} catch (\PhpOffice\PhpSpreadsheet\Reader\Exception $e) {
    \Log::error('Excel read failed: ' . $e->getMessage());
    throw $e;
}

✅ 最终效果验证

执行命令后，数据库将正确写入： | id | price | size | product | |----|--------|------|-------------| | 1 | 1.20 | M | banana | | 2 | 0.85 | S | banana | | 3 | 3.50 | L | strawberry | | 4 | 2.99 | M | strawberry |

每条记录的 product 字段严格对应其原始所在 Sheet 名称，彻底解决“只存第一个 Sheet 名”的问题。