直接new excelreader()报“class not found”是因为thinkphp未内置excel解析能力，excelreader并非框架类或composer自动加载类，正确方案是使用phpoffice/phpspreadsheet并严格遵循psr-4自动加载、全命名空间（如phpoffice\phpspreadsheet\iofactory）及php版本要求（tp6+需php≥7.2，phpspreadsheet^1.20需php≥7.4）。
为什么直接 new ExcelReader() 会报 “Class not found”
ThinkPHP 本身不带 Excel 解析能力，ExcelReader 不是框架内置类，也不是 Composer 自动加载的合法命名空间类。你看到的报错，本质是 PHP 找不到这个类定义——它要么根本没安装，要么路径/命名空间写错，要么用了已废弃的旧库（如过时的 PHPExcel）。
正确路径只有一条：用 phpoffice/phpspreadsheet，且必须走 Composer 正规安装 + PSR-4 自动加载。TP5.1 要求 PHP ≥ 7.1，TP6 要求 ≥ 7.2，而 phpspreadsheet ^1.20 起已强制要求 PHP 7.4+，版本不匹配也会导致类加载失败。
- 别手动下载 ZIP 放到
Vendor目录——TP6 已弃用vendor()函数，且无自动注册机制 - 别写
use ExcelReader或import("ExcelReader")——这些在 TP6+ 中完全无效 - 必须用全限定命名空间：
use PhpOffice\PhpSpreadsheet\IOFactory;，漏掉PhpOffice\前缀就加载失败
IOFactory::load() 和 IOFactory::createReader() 怎么选
IOFactory::load($path) 是“全自动猜测格式”模式，看似方便，实则隐患多：它要读文件头、试解析多种格式，容易误判（比如把 .xls 当成 .xlsx），且无法控制内存行为；而 IOFactory::createReader('Xlsx') 是显式指定格式，更快、更稳、更可控。
尤其上传场景下，客户端传来的 $_FILES['file']['type'] 完全不可信（可被伪造），不能作为格式依据。应结合文件扩展名硬判断，并优先使用显式 reader。
- 只允许
.xlsx和.xls，拒绝.csv（它不是 Excel 格式，phpspreadsheet默认不支持 CSV 读取，会报错） - 用
pathinfo($filePath, PATHINFO_EXTENSION)取真实后缀，转大写后映射为 reader 类型：'xlsx' → 'Xlsx'，'xls' → 'Xls' - 显式创建 reader 后，调用
$reader->setReadDataOnly(true)可跳过公式、样式等非数据内容，大幅降低内存占用
读取大文件时如何避免内存爆掉
直接 IOFactory::load() 整体加载一个 10 万行 Excel，在默认 512MB 内存限制下极易崩溃。关键不是“怎么读”，而是“怎么分段读+跳过无效行”。
核心是放弃 getActiveSheet()->toArray() 这种全量转数组方式，改用迭代器逐行遍历，并主动过滤空行和无效列。
- 用
$worksheet->getRowIterator(1)从第 2 行开始（跳过表头），避免getRowIterator()从第 1 行起查空行逻辑干扰 - 对每行调用
$cellIterator->setIterateOnlyExistingCells(false)，确保空单元格也被遍历到，否则getValue()拿不到 null 值，无法判断是否全空 - 用
array_filter($rowData, 'strlen')判断该行是否有有效内容，比array_filter($rowData)更安全（防止数字 0 被误滤） - 单次处理不超过 500 行，用
Db::transaction()包裹批量插入，避免长事务锁表
字段映射和清洗为什么不能省略
Excel 表头是中文（如“手机号”）、数据库字段是 mobile；Excel 填了“是/否”，但数据库是 TINYINT(1)；某列混入了空格、换行符或全角字符——这些都会在插入时触发 SQL 错误或数据错位。
映射必须硬编码在代码里，不能靠“自动识别”。清洗必须在入库前完成，不能依赖 MySQL 的宽松模式。
- 第一行必须是表头，用
$worksheet->rangeToArray('A1:'.$highestColumn.'1')[0]提前提取，再构建键值映射数组：['手机号' => 'mobile', '是否启用' => 'status'] - 对每个单元格值做 trim()、str_replace(["\r\n", "\n", "\r"], '', $val)、iconv('GBK', 'UTF-8//IGNORE', $val)（兼容老 Excel）
- 状态类字段（是/否、启用/禁用）需统一转为 1/0；日期字段用
\PhpOffice\PhpSpreadsheet\Shared\Date::excelToDateTimeObject()解析，别直接强转字符串 - 导入完成后立即
unlink($filePath)清理临时文件，否则上传目录会堆积大量未清理文件
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
