当前位置：首页 > 虚拟主机 > 正文

php如何上传excel文件并导入到数据库？详细步骤是怎样的？

admin
虚拟主机
2025-12-19
6

在Web开发中,经常需要处理Excel文件的导入功能，例如批量导入用户信息、产品数据等，PHP作为流行的服务器端脚本语言，结合Excel文件处理库，可以轻松实现Excel文件上传并导入数据库的功能，本文将详细介绍如何使用PHP实现这一功能，包括环境准备、文件上传、Excel解析、数据入库及错误处理等环节。

环境准备与依赖安装

确保服务器已安装PHP环境（建议PHP 7.0及以上版本），并启用必要的扩展，如fileinfo（用于文件类型检测）、pdo或mysqli（用于数据库操作），需要安装PHPExcel库（现升级为PhpSpreadsheet）来处理Excel文件，可以通过Composer安装：

composer require phpoffice/phpspreadsheet

安装完成后,在PHP文件中引入自动加载文件：

php如何上传excel文件并导入到数据库？详细步骤是怎样的？第1张

创建上传表单与前端页面

在前端页面中,需要创建一个表单用于上传Excel文件，表单的enctype必须设置为multipart/formdata，以支持文件上传，示例代码如下：

<form action="upload.php" method="post" enctype="multipart/formdata"> <input type="file" name="excel_file" accept=".xlsx, .xls" required> <button type="submit">上传并导入</button> </form>

accept属性限制上传文件类型为Excel（.xlsx或.xls），避免用户上传非Excel文件。

处理文件上传与安全验证

在服务器端（如upload.php），首先需要验证文件上传是否成功，并对文件进行安全检查，以下是关键步骤：

php如何上传excel文件并导入到数据库？详细步骤是怎样的？第2张

检查错误状态：通过$_FILES['excel_file']['error']判断上传是否成功（错误码为0表示成功）。
验证文件类型：使用finfo或mime_content_type()检测文件MIME类型，确保为Excel文件。
限制文件大小：通过$_FILES['excel_file']['size']限制文件大小（如不超过10MB）。
生成唯一文件名：使用uniqid()或时间戳重命名文件，避免文件名冲突。

示例代码：

if ($_FILES['excel_file']['error'] !== 0) { die('文件上传失败，错误码：' . $_FILES['excel_file']['error']); } // 检查文件类型 $finfo = finfo_open(FILEINFO_MIME_TYPE); $mimeType = finfo_file($finfo, $_FILES['excel_file']['tmp_name']); finfo_close($finfo); $allowedTypes = ['application/vnd.openxmlformatsofficedocument.spreadsheetml.sheet', 'application/vnd.msexcel']; if (!in_array($mimeType, $allowedTypes)) { die('仅支持Excel文件（.xlsx或.xls）'); } // 限制文件大小（10MB） $maxSize = 10 * 1024 * 1024; if ($_FILES['excel_file']['size'] > $maxSize) { die('文件大小不能超过10MB'); } // 生成唯一文件名并移动到上传目录 $uploadDir = 'uploads/'; if (!file_exists($uploadDir)) { mkdir($uploadDir, 0777, true); } $fileName = uniqid() . '_' . $_FILES['excel_file']['name']; move_uploaded_file($_FILES['excel_file']['tmp_name'], $uploadDir . $fileName);

解析Excel文件并提取数据

使用PhpSpreadsheet库解析上传的Excel文件,提取数据并转换为数组，以下是关键步骤：

加载Excel文件：通过PhpOfficePhpSpreadsheetIOFactory加载文件。
选择工作表：默认读取第一个工作表，可通过索引或名称指定。
提取数据：遍历行和列，将数据存入二维数组。

示例代码：

php如何上传excel文件并导入到数据库？详细步骤是怎样的？第3张

use PhpOfficePhpSpreadsheetIOFactory; $spreadsheet = IOFactory::load($uploadDir . $fileName); $sheet = $spreadsheet>getActiveSheet(); $data = []; // 获取总行数和列数 $highestRow = $sheet>getHighestRow(); $highestColumn = $sheet>getHighestColumn(); // 遍历行（跳过表头，假设从第二行开始） for ($row = 2; $row <= $highestRow; $row++) { $rowData = []; for ($col = 'A'; $col <= $highestColumn; $col++) { $rowData[] = $sheet>getCell($col . $row)>getValue(); } $data[] = $rowData; } // 释放内存 unlink($uploadDir . $fileName);

数据验证与入库

在将数据存入数据库前,需进行验证（如字段非空、格式正确等），然后批量插入数据库，以下是示例：

数据库连接：使用PDO或MySQLi建立连接。
预处理SQL语句：防止SQL载入。
批量插入：使用PDO::exec()或循环执行单条插入。

示例代码（PDO）：

try { $pdo = new PDO('mysql:host=localhost;dbname=test_db', 'username', 'password'); $pdo>setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION); // 假设Excel包含姓名、年龄、邮箱三列 $sql = "INSERT INTO users (name, age, email) VALUES (?, ?, ?)"; $stmt = $pdo>prepare($sql); foreach ($data as $row) { // 数据验证（示例：检查邮箱格式） if (!filter_var($row[2], FILTER_VALIDATE_EMAIL)) { continue; // 跳过无效数据 } $stmt>execute($row); } echo '数据导入成功，共插入 ' . count($data) . ' 条记录'; } catch (PDOException $e) { die('数据库错误：' . $e>getMessage()); }