ThinkPHP怎么导入xlsx文件 完整配置教程分享

在ThinkPHP项目里导入.xlsx格式的Excel文件，有一个关键原则：必须显式指定Xlsx Reader类型，绝对不能依赖自动探测。原因很简单——.xls和.xlsx底层结构完全不同，自动识别一旦遇到扩展名被篡改或者缺失的情况，就会直接翻车。与其把命运交给运气，不如从一开始就锁死读取器类型。

确认环境与依赖

首先，确保项目已经安装好phpspreadsheet（推荐，适用于TP6+及新版TP5），或者兼容旧版的PHPExcel（如果你还在维护TP3/TP5的老项目）。phpspreadsheet的安装很简单，执行 composer require phpoffice/phpspreadsheet 就行。如果用PHPExcel，就把库文件扔进 Vendor/PHPExcel 目录并正确引入。

【关键前提】PHP必须开启zip和xml扩展，否则读取Xlsx时直接报 Class 'ZipArchive' not found 或者解析中断，根本走不下去。

上传文件并校验后缀

前端表单要设置 enctype="multipart/form-data"，name 属性例如 file。后端拿到上传文件后，用 pathinfo($file->getOriginalName(), PATHINFO_EXTENSION) 安全提取扩展名。这里有个常踩的坑：千万别放 .csv 进来——它不是真正的Excel格式，phpspreadsheet会直接解析失败。

只允许 .xls 和 .xlsx，其他统统拦截：

if (!in_array(strtolower($ext), ['xls', 'xlsx'])) {
    $this->error('仅支持.xls或.xlsx文件');
}

选择Reader并加载文件

方法一：phpspreadsheet（推荐，TP6+及新版TP5适用）

根据后缀显式创建Reader：

$reader = \PhpOffice\PhpSpreadsheet\IOFactory::createReader('Xlsx'); // .xlsx用Xlsx，.xls用Xls

【不可逆操作】千万不要偷懒用 IOFactory::load()，它会尝试自动探测格式。一旦对方传了一个伪装成 .xlsx 的 .xls 文件，就会抛出异常，而且你很难抓到具体原因——调试半天都找不出问题。

方法二：PHPExcel（TP3/TP5旧项目）

$objReader = PHPExcel_IOFactory::createReader('Excel2007'); // 对应.xlsx
// 或 Excel5 对应.xls
$objPHPExcel = $objReader->load($filePath);

读取工作表并跳过空行

第一步：获取当前活动工作表：

$worksheet = $spreadsheet->getActiveSheet();

第二步：遍历所有行，但务必启用全单元格迭代，否则空列会被跳过：

$rowIterator = $worksheet->getRowIterator();

第三步：对每一行，重置单元格迭代器以包含空单元格：

$cellIterator->setIterateOnlyExistingCells(false);

第四步：逐单元格取值并收集，然后用 array_filter($rowData) 判断是否全为空——这是唯一可靠跳过空行的方式。用 getHighestRow() 会漏掉末尾空行，用 isEmpty() 方法也不可靠，很多坑等着你。

写入数据库前清洗数据

遍历 $data 数组时，跳过首行（表头）：

if ($i === 0) continue;

对每个字段做 trim() 和 null 转换：

$value = is_null($cell->getValue()) ? '' : trim((string)$cell->getValue());

别直接用 toArray()——它会把整张表一次性加载进内存，10万行Excel极易触发OOM（内存溢出）。手动遍历行+单元格才能精确控制内存占用，这才是正经的生产级写法。