ThinkPHP如何做数据导入_ThinkPHP Excel数据批量导入【教程】-ThinkPHP-PHP中文网

ExcelReader报“Class not found”是因ThinkPHP未内置Excel解析能力，需用phpoffice/phpspreadsheet；须正确配置自动加载、命名空间及PHP版本，并安全读取、清洗、分批导入数据。

thinkphp如何做数据导入_thinkphp excel数据批量导入【教程】

为什么 `ExcelReader` 在 ThinkPHP 里常报 “Class not found”

不是 ThinkPHP 缺这个类，是它压根没内置 Excel 解析能力。官方只提供数据库和请求处理，Excel 导入得靠第三方库，比如 phpoffice/phpspreadsheet —— 但直接 composer require phpoffice/phpspreadsheet 后，很多人卡在自动加载失败或命名空间写错。

别用过时的 PHPExcel，已停止维护，ThinkPHP 6+ 的 PSR-4 自动加载和它不兼容
use PhpOffice\PhpSpreadsheet\IOFactory; 必须写全，漏掉 PhpOffice\ 前缀就报错
如果用的是 ThinkPHP 5.1，注意 PHP 版本不能低于 7.1；TP6 要求 PHP ≥ 7.2，而 phpspreadsheet 1.20+ 需要 PHP 7.4+
上传文件后，别直接传 $_FILES['file']['tmp_name'] 给 IOFactory::load() —— 它需要真实路径，且 PHP 进程要有读权限

怎么安全地读取上传的 Excel 并转成二维数组

核心是控制输入来源、限制格式、避免内存爆炸。直接 IOFactory::load($path) 读整个文件，在 10 万行 Excel 上可能吃光 512MB 内存。

先校验文件后缀和 MIME 类型：$_FILES['file']['type'] 是客户端传的，不可信；要用 finfo_file() 检查真实类型
只允许 .xlsx 和 .xls，拒绝 .csv（它不是 Excel 格式，phpspreadsheet 会解析失败）
用 IOFactory::createReader('Xlsx') 显式指定格式，比 load() 更快、更可控
读取时跳过空行：调用 $worksheet->getRowIterator() 遍历，再用 $cell->getValue() !== null 判断是否为空单元格

示例片段：

$reader = IOFactory::createReader('Xlsx');<br>$spreadsheet = $reader->load($filePath);<br>$worksheet = $spreadsheet->getActiveSheet();<br>$data = [];<br>foreach ($worksheet->getRowIterator() as $row) {<br>    $cellIterator = $row->getCellIterator();<br>    $cellIterator->setIterateOnlyExistingCells(false);<br>    $rowData = [];<br>    foreach ($cellIterator as $cell) {<br>        $rowData[] = $cell->getValue();<br>    }<br>    if (array_filter($rowData)) { // 跳过全空行<br>        $data[] = $rowData;<br>    }<br>}

批量插入前，为什么一定要做字段映射和数据清洗

Excel 表头可能是中文（如“用户姓名”），而数据库字段是 user_name；某列填了“是/否”，但数据库是 tinyint(1)。不做映射直接插，要么字段错位，要么触发 SQL 错误。

Excel XLSX Formula Cleanup

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

下载

第一行必须是表头，且需硬编码映射规则，例如：['用户姓名' => 'user_name', '注册时间' => 'created_at']，不能靠“猜”
日期列要用 \PhpOffice\PhpSpreadsheet\Shared\Date::excelToDateTimeObject() 转，否则得到的是数字（如 44562），不是时间戳
手机号、邮箱要 trim() + 正则过滤空白符和全角字符，Excel 里粘贴常带不可见 Unicode 空格
数值列小心科学计数法：Excel 把长数字（如身份证）转成 1.23E+17，读出来就是浮点数，精度丢失——得用 $cell->getDataType() === 's' 强制当字符串读

大文件导入卡死或超时，TP 自带的 `Db::transaction()` 还能用吗

能用，但不是“包治百病”。事务只保证原子性，不解决内存和超时问题。10 万行一次性 insertAll()，MySQL 可能锁表几十秒，PHP 进程早被 Nginx 或 PHP-FPM 杀掉。

必须分批：每 500 行提交一次事务，用 array_chunk($data, 500) 切分，别设成 1000 或 50 —— 太小频繁提交拖慢速度，太大仍可能超内存
禁用模型事件：如果用了 ThinkPHP 模型，导入时关掉 event(false)，否则每个 save() 都触发 before_insert 回调，放大性能损耗
CLI 模式下执行更稳：Web 请求有超时限制（如 Nginx 的 fastcgi_read_timeout），改用 php think import:excel /path/to/file.xlsx 命令行方式
别依赖 Db::getLastInsID() 获取自增 ID —— 批量插入时它只返回第一条的 ID，要 ID 列表得自己构造 INSERT ... VALUES (),(),() RETURNING id（仅 PostgreSQL）或分条插入