ThinkPHP导入Excel如何自动映射字段：操作教程

ThinkPHP导入Excel需定义字段映射规则，将表头“用户姓名”“注册时间”“是否启用”对应数据库字段user_name、reg_time、status，在ImportUser模型中通过$fieldMap属性配置映射关系，并清洗表头、逐行转换、归一化枚举值后批量插入。

ThinkPHP导入Excel时，表头是“用户姓名”“注册时间”“是否启用”，而数据库字段却是user_name、reg_time、status，不处理字段映射直接入库就会错位或报错。

准备映射规则与Excel解析器

先确认你用的是 ThinkPHP 6.x + PhpSpreadsheet（不是已废弃的 PHPExcel），并在 composer 中已安装：composer require phpoffice/phpspreadsheet。

创建一个 Excel 导入专用模型类，比如 appmodelImportUser，不要复用业务模型——字段映射逻辑要隔离，避免污染主模型。

在该模型中定义 【$fieldMap】 属性，键为 Excel 表头原文（或清洗后标准名），值为对应数据库字段名：
protected $fieldMap = ['用户姓名' => 'user_name', '注册时间' => 'reg_time', '是否启用' => 'status'];

立即学习“PHP免费学习笔记（深入）”；

读取Excel并清洗表头

使用 PhpSpreadsheet 的 IOFactory::load() 加载上传文件，获取首行作为原始表头数组。

对原始表头做 trim() 和空格清理，再逐项匹配 $fieldMap 键；若某列标题完全不在映射表里，直接跳过该列，不参与后续写入——防止未知字段污染数据。

这一步必须在循环数据行前完成，否则无法确定哪一列对应哪个数据库字段。

逐行转换并批量插入

从第二行开始遍历数据行（$worksheet->getRowIterator(2)），对每一行执行：

① 用当前行单元格值构建临时数组 $rowRaw，索引为清洗后的表头名（如 '用户姓名' => '张三'）；

② 遍历 $this->fieldMap，将 $rowRaw[$mapKey] 赋给新数组 $mappedData[$mapValue]，例如把 $rowRaw['用户姓名'] → $mappedData['user_name']；

③ 对 status 这类枚举字段做值归一化：遇到“是/启用/true”统一转为 1，遇到“否/禁用/false”转为 0，其他值设为 0 并记录警告日志——不校验就直插会导致脏数据。

所有行处理完后，调用 User::insertAll($allMappedData) 批量写入，比单条 save() 快 5～10 倍。