ThinkPHP导入Excel需要什么插件：快速配置指南
在ThinkPHP中实现Excel导入必须使用phpspreadsheet库，禁用已停止维护的PHPExcel；需确认PHP≥7.2、TP≥6.0，安装后执行composer dump-autoload；仅按文件后缀引入对应Reader类，用getRealPath()获取路径，显式指定Reader类型，启用setReadDataOnly(true)，并流式遍历行与单元格。
在ThinkPHP项目中实现Excel导入功能，必须使用phpspreadsheet库，PHPExcel已彻底停止维护且与TP6/TP7不兼容，直接引入会导致Class not found或ParseError。
确认当前ThinkPHP版本与PHP环境
打开命令行，执行php -v和composer show thinkphp/framework，确认PHP ≥ 7.2、ThinkPHP ≥ 6.0。若为TP5.x，仍需强制切换至phpspreadsheet——【不要尝试降级适配PHPExcel】，否则将在日期解析、XLSX读取、内存控制等环节持续报错。
安装phpspreadsheet依赖
进入项目根目录，执行以下命令：
composer require phpoffice/phpspreadsheet
立即学习“PHP免费学习笔记（深入）”；
安装完成后，检查vendor/autoload.php是否已被TP自动加载；若后续报Class 'PhpOfficePhpSpreadsheetIOFactory' not found，90%是因未运行composer dump-autoload刷新自动加载映射。
引入并实例化Reader类
在控制器或服务类顶部，按需引入最小必要类：
use PhpOfficePhpSpreadsheetIOFactory;
use PhpOfficePhpSpreadsheetReaderXlsx;
use PhpOfficePhpSpreadsheetReaderXls;
【禁止全局引入所有Reader类】——仅根据上传文件后缀选择其一，避免autoload冗余加载拖慢响应。
安全获取上传文件路径
第一步：用ThinkPHP原生方法获取上传对象
$file = request()->file('excel');
第二步：调用getRealPath()获取真实可读路径
$path = $file->getRealPath();
⚠️ 注意：getPathname()返回的是临时文件名（如/tmp/phpXXXXXX），该路径在Swoole或多进程环境下极不可靠，【必须用getRealPath()】，否则IOFactory::load()必报“File does not exist”。
按扩展名显式指定Reader类型
方法一：手动判断后缀并实例化
$ext = pathinfo($file->getOriginalName(), PATHINFO_EXTENSION);
if ($ext === 'xlsx') { $reader = new Xlsx(); } else if ($ext === 'xls') { $reader = new Xls(); }
方法二：用IOFactory::createReader()（需严格匹配字符串）
$reader = IOFactory::createReader(strtoupper($ext) === 'XLSX' ? 'Xlsx' : 'Xls');
【不能省略这一步】——自动探测（auto-detect）在扩展名被篡改、无后缀或混合格式场景下极易失败，直接导致Invalid reader异常。
加载时跳过样式与公式
在调用load()前，务必启用数据只读模式：
$reader->setReadDataOnly(true);
这一步能跳过单元格样式、条件格式、公式计算等非结构化内容，使10MB Excel的内存占用从380MB降至45MB以内，同时避免因公式解析失败导致的Fatal error。
流式遍历工作表避免内存爆炸
第一步：获取首张工作表
$worksheet = $spreadsheet->getActiveSheet();
第二步：启用行迭代器
$rowIterator = $worksheet->getRowIterator();
第三步：对每一行启用单元格迭代器，并跳过空白单元格
foreach ($rowIterator as $row) {
$cellIterator = $row->getCellIterator();
$cellIterator->setIterateOnlyExistingCells(true);
foreach ($cellIterator as $cell) {
// 处理 $cell->getValue()
}
}
✅ 正确做法：边读边处理，不调用toArray()；❌ 错误写法：$worksheet->toArray()——该方法会将整张表（含隐藏列、合并单元格残留、数万空行）一次性载入内存，极易触发Allowed memory size exhausted。
