当前位置：首页 > 文章列表 > 文章 > php教程 > Excel数据导入导出方法，PhpSpreadsheet使用教程

Excel数据导入导出方法，PhpSpreadsheet使用教程

2025-08-03 20:55:28 0浏览收藏

推广推荐

支持 PC / 移动端，安全直达

本文详细介绍了如何使用PhpSpreadsheet这一强大的PHP库实现Excel数据的导入导出功能。通过Composer安装PhpSpreadsheet后，您可以轻松地创建、读取和操作Excel文件。文章从安装步骤、导出流程（包括创建对象、设置表头、写入数据及保存下载）和导入步骤（涵盖文件上传、读取解析、数据校验及数据库插入）等方面进行了详细讲解，并提供了示例代码。同时，还提醒了在实际操作中需要注意的问题，例如表头与数据对齐、内存管理、文件名编码、列顺序错位、空行处理以及格式兼容性等。无论您是需要将数据导出为Excel报表，还是从Excel表格中导入数据到系统中，PhpSpreadsheet都是一个高效可靠的选择。掌握本文内容，您将能够轻松应对各种Excel数据处理需求。

PhpSpreadsheet可通过Composer安装并实现Excel导入导出。1. 安装时使用命令composer require phpoffice/phpspreadsheet并引入autoload.php；2. 导出流程为创建对象→设置表头→写入数据→保存下载，注意对齐表头与数据、处理内存及文件名编码；3. 导入步骤包括上传文件→读取解析→遍历校验数据→插入数据库，需防范列顺序错位、空行异常及格式兼容问题。

Excel数据如何导入导出？PhpSpreadsheet使用指南

在处理Excel文件时，PhpSpreadsheet是一个非常实用的PHP库，支持读写多种格式，比如XLSX、CSV等。如果你需要在项目中实现Excel数据的导入导出功能，用这个工具就挺合适。

安装PhpSpreadsheet

要使用PhpSpreadsheet，首先得安装它。推荐使用Composer进行安装，这样可以自动处理依赖关系。运行以下命令：

composer require phpoffice/phpspreadsheet

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

require 'vendor/autoload.php';

这样就可以开始调用了。

导出数据到Excel

导出数据其实就是把数据库或者数组中的内容写入Excel表格。基本流程是：创建对象 → 设置表头 → 写入数据 → 保存并下载。

下面是一个简单的例子：

use PhpOffice\PhpSpreadsheet\Spreadsheet;
use PhpOffice\PhpSpreadsheet\Writer\Xlsx;

$spreadsheet = new Spreadsheet();
$sheet = $spreadsheet->getActiveSheet();

// 设置表头
$headers = ['姓名', '年龄', '城市'];
$sheet->fromArray($headers, null, 'A1');

// 假设这是你要导出的数据
$data = [
    ['张三', 28, '北京'],
    ['李四', 30, '上海'],
];

// 写入数据
foreach ($data as $rowIndex => $rowData) {
    $sheet->fromArray($rowData, null, 'A' . ($rowIndex + 2));
}

// 保存为Excel文件并强制浏览器下载
header('Content-Type: application/vnd.openxmlformats-officedocument.spreadsheetml.sheet');
header('Content-Disposition: attachment;filename="export.xlsx"');
header('Cache-Control: max-age=0');

$writer = new Xlsx($spreadsheet);
$writer->save('php://output');
exit;

这样用户就能直接下载一个包含你数据的Excel文件了。

注意事项：

表头和数据对齐很重要，不然打开后会乱。
如果数据量大，要注意内存问题，适当分批次处理。
文件名尽量用英文，中文容易出现编码问题。

导入Excel数据到系统

导入的过程就是从Excel中读取数据，然后解析成PHP数组或插入数据库。步骤大致如下：

上传Excel文件
使用PhpSpreadsheet读取
遍历每一行数据
校验并处理数据（如过滤空行）
插入数据库或做其他操作

示例代码如下：

if ($_FILES['excel_file']['error'] === UPLOAD_ERR_OK) {
    $tmpName = $_FILES['excel_file']['tmp_name'];

    $spreadsheet = \PhpOffice\PhpSpreadsheet\IOFactory::load($tmpName);
    $sheetData = $spreadsheet->getActiveSheet()->toArray();

    // 假设第一行为标题，跳过
    array_shift($sheetData);

    foreach ($sheetData as $row) {
        // 处理每一行数据，例如插入数据库
        // insert into users (name, age, city) values ($row[0], $row[1], $row[2]);
    }
}