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。