ThinkPHP6.0Excel数据导入_ThinkPHP6.0导入Excel表格教程【功能】-ThinkPHP-PHP中文网

phpspreadsheet 是 thinkphp6.0 导入 excel 的唯一推荐方案，需按规范安装、引入类、安全上传、指定 reader、跳过样式、正确读取行列、转换日期、校验+事务入库，并处理文本型数字。

thinkphp6.0excel数据导入_thinkphp6.0导入excel表格教程【功能】

phpoffice/phpspreadsheet 是当前 ThinkPHP6.0 中导入 Excel 的事实标准方案，PHPExcel 已停止维护，**不要用**。直接上 phpspreadsheet，否则后续会踩到编码、日期解析、大文件内存溢出、XLSX/XLS 兼容性等一堆坑。

安装和基础引入必须做对

执行命令安装（注意：TP6 要求 PHP ≥ 7.2，phpspreadsheet ≥ 1.25）：

composer require phpoffice/phpspreadsheet

在控制器或服务类中，只引入真正用到的类，避免 autoload 冗余加载：

use PhpOffice\PhpSpreadsheet\IOFactory; —— 必须，用于读取文件
use PhpOffice\PhpSpreadsheet\Reader\Xlsx; 或 use PhpOffice\PhpSpreadsheet\Reader\Xls; —— 按需选其一，比 IOFactory::createReader() 更明确、更可控
不用 setReadDataOnly(true) 就别引入 Style 相关类，省内存

常见错误：Class 'PhpOffice\PhpSpreadsheet\IOFactory' not found，90% 是没执行 composer dump-autoload 或 autoloader 缓存未刷新；确认 vendor/autoload.php 已被 TP6 自动加载。

上传后读取 Excel 文件的正确姿势

不能直接读取 $_FILES 的临时路径并传给 IOFactory::load()，因为权限/路径可能被框架拦截或重写。应先移动到可读目录（如 runtime/upload/），再读取：

检查文件扩展名是否为 xlsx 或 xls，仅靠 MIME 类型不可信
用 move_uploaded_file() 安全转移，不要用 copy() 或直接 open
读取时指定 reader 类型，避免自动探测失败（比如 .xlsx 文件被误判为 .csv）：

$reader = new \PhpOffice\PhpSpreadsheet\Reader\Xlsx();
$reader->setReadDataOnly(true); // 关键：跳过样式、公式，大幅提升速度和稳定性
$spreadsheet = $reader->load($filePath);

若要支持旧版 .xls，换用 \PhpOffice\PhpSpreadsheet\Reader\Xls；混用格式建议先用 pathinfo($filename, PATHINFO_EXTENSION) 判断再实例化对应 reader。

excel-clean

Excel 数据清洗——去重、填补缺失值、格式转换。

下载

逐行读取数据时最容易崩的几个点

表头通常在第 1 行，数据从第 2 行开始，但 getHighestRow() 可能返回空行或隐藏行，导致循环越界或漏数据：

用 $worksheet->getHighestDataRow() 替代 getHighestRow()（后者含空行）
列索引从 1 开始，不是 0：getCellByColumnAndRow(1, $row) 对应 A 列，不是 A$row
空单元格返回 null 或空字符串，数据库插入前必须做 isset() / !empty() 判断，否则报错或写入脏数据
日期字段默认转成 Excel 序数（如 44562），需用 \PhpOffice\PhpSpreadsheet\Shared\Date::excelToDateTimeObject() 转换，否则入库是数字而非时间

示例片段（安全读取用户名和创建时间）：

$cellA = $worksheet->getCellByColumnAndRow(1, $row);
$username = $cellA ? trim($cellA->getValue()) : '';
$cellC = $worksheet->getCellByColumnAndRow(3, $row);
$rawDate = $cellC ? $cellC->getValue() : null;
$createTime = is_numeric($rawDate) 
    ? \PhpOffice\PhpSpreadsheet\Shared\Date::excelToDateTimeObject($rawDate)->format('Y-m-d H:i:s')
    : ($rawDate ?: null);

批量入库前务必加校验和事务

Excel 导入本质是“用户提交的非结构化输入”，不能信任任何字段。跳过校验直接 create()，轻则报错中断，重则注入脏数据或破坏业务逻辑：

每行数据进 DB 前，用模型的 validate() 或独立验证器检查必填、格式（手机号、邮箱）、长度等
使用事务包裹整个导入过程：Db::transaction()，任一行失败就回滚，避免部分写入
单次导入超过 500 行，建议分批（如每 100 行 commit 一次），防止超时或内存耗尽
导出错误详情时，记录具体哪一行、哪一列出错（如 "第3行，C列：手机号格式错误"），而不是笼统抛异常

最常被忽略的是：Excel 单元格里看似是数字，但实际是文本格式（尤其带前导零的编号、身份证号），getValue() 默认会转成 int 导致截断。要用 getFormattedValue() 或提前设置 setReadDataOnly(false) + getCellDataType() 判断类型。

php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！