使用 PHPSpreadsheet 修改和保存现有 Excel 文件的完整指南-php教程-PHP中文网

使用 PHPSpreadsheet 修改和保存现有 Excel 文件的完整指南

DDD

发布： 2025-08-29 14:29:14

原创

838人浏览过

使用 PHPSpreadsheet 修改和保存现有 Excel 文件的完整指南

本文详细介绍了如何使用 PHPSpreadsheet 库加载、修改并保存现有 Excel 文件。我们将探讨正确的加载和写入流程，包括如何获取工作表、设置单元格值以及在现有数据后追加新行，并强调使用 IOFactory::createWriter 方法来避免常见错误，确保文件操作的稳定性和正确性。

PHPSpreadsheet 文件操作核心流程

使用 phpspreadsheet 对现有 excel 文件进行操作，通常遵循以下三个核心步骤：

加载现有文件： 将目标 Excel 文件读取到 PHPSpreadsheet 的 Spreadsheet 对象中。
修改数据： 通过 Spreadsheet 对象访问特定的工作表和单元格，进行数据的添加、修改或删除。
保存更改： 将修改后的 Spreadsheet 对象重新写入文件系统，覆盖或创建新的 Excel 文件。

正确加载现有 Excel 文件

要修改一个现有的 Excel 文件，首先需要将其加载到内存中。PHPSpreadsheet 提供了 IOFactory 类来简化这一过程，它能根据文件扩展名自动识别合适的读取器。

<?php

require 'vendor/autoload.php'; // 确保引入 Composer 自动加载文件

use PhpOffice\PhpSpreadsheet\IOFactory;
use PhpOffice\PhpSpreadsheet\Spreadsheet;

// 定义要操作的 Excel 文件路径
$filePath = 'yourspreadsheet.xlsx';

// 1. 创建一个读取器实例
// IOFactory::createReader() 方法会根据文件类型（如 "Xlsx", "Csv" 等）返回一个合适的读取器对象。
$reader = IOFactory::createReader("Xlsx");

// 2. 使用读取器加载文件到 Spreadsheet 对象
// 如果文件不存在或无法读取，此方法可能会抛出异常，建议进行错误处理。
try {
    $spreadsheet = $reader->load($filePath);
} catch (\PhpOffice\PhpSpreadsheet\Reader\Exception $e) {
    die('加载 Excel 文件时发生错误: ' . $e->getMessage());
}

// 至此，$spreadsheet 对象已包含 Excel 文件的所有数据
echo "文件 '{$filePath}' 已成功加载。\n";
?>

登录后复制

说明：

IOFactory::createReader("Xlsx") 显式地创建了一个 XLSX 格式的读取器。这比直接使用 IOFactory::load($filePath) 更具控制性，尤其是在需要为读取器设置特定选项时。
$reader->load($filePath) 将文件内容解析并存储在一个 PhpOffice\PhpSpreadsheet\Spreadsheet 类的实例中。

在工作表中进行数据修改

加载文件后，你可以通过 Spreadsheet 对象访问其包含的工作表，并对单元格数据进行操作。

获取活动工作表

通常，我们会对文件的活动工作表进行操作，或者通过索引/名称获取特定工作表。

立即学习“PHP免费学习笔记（深入）”；

// 获取当前活动的工作表
$sheet = $spreadsheet->getActiveSheet();

// 或者通过索引获取工作表 (0 代表第一个工作表)
// $sheet = $spreadsheet->getSheet(0);

// 或者通过名称获取工作表
// $sheet = $spreadsheet->getSheetByName('Sheet1');

登录后复制

设置单元格值

使用 $sheet->setCellValue() 方法可以修改或设置指定单元格的值。

// 修改 A1 单元格的值
$sheet->setCellValue('A1', '新的表头');

登录后复制

示例：在现有数据后追加新行

一个常见的需求是在现有数据的末尾追加新行。这可以通过获取当前工作表的最高行数，然后在其基础上加一来确定新行的位置。

图改改

在线修改图片文字

455

查看详情

// 获取当前工作表的最高行数
$last_row = (int) $sheet->getHighestRow();

// 计算新行的行号
$new_row = $last_row + 1;

// 在新行中设置数据
$sheet->setCellValue('A' . $new_row, "14");
$sheet->setCellValue('B' . $new_row, "Alina");
$sheet->setCellValue('C' . $new_row, "PG");
$sheet->setCellValue('D' . $new_row, "$32");
$sheet->setCellValue('E' . $new_row, "Pending");

echo "已在第 {$new_row} 行追加新数据。\n";

登录后复制

保存修改后的 Excel 文件

完成数据修改后，需要将 Spreadsheet 对象的内容保存回文件系统。

关键：使用 IOFactory::createWriter()

这是解决文章开头提到的 TypeError 的关键所在。PHPSpreadsheet 推荐使用 IOFactory::createWriter() 方法来创建写入器对象，而不是直接实例化 PhpOffice\PhpSpreadsheet\Writer\Xlsx 等类。

为什么 IOFactory::createWriter() 更优？

抽象性： IOFactory 负责根据指定的文件类型（如 "Xlsx"）返回正确的写入器实例，你无需关心具体的写入器类名和其命名空间。
鲁棒性： 它能确保传入的 Spreadsheet 对象是有效的，并处理一些内部初始化逻辑。直接实例化 new Xlsx($spreadsheet) 可能因为命名空间问题、或在 $spreadsheet 对象为 null（例如加载失败时）的情况下导致 TypeError。

// 1. 创建一个写入器实例
// IOFactory::createWriter() 方法接受 Spreadsheet 对象和文件类型作为参数
$writer = IOFactory::createWriter($spreadsheet, "Xlsx");

// 2. 保存文件
// 如果指定的文件名与加载时相同，则会覆盖原文件。
try {
    $writer->save($filePath);
    echo "文件 '{$filePath}' 已成功保存。\n";
} catch (\PhpOffice\PhpSpreadsheet\Writer\Exception $e) {
    die('保存 Excel 文件时发生错误: ' . $e->getMessage());
}

登录后复制

完整示例代码

以下是一个完整的 PHP 脚本，演示了如何加载现有 yourspreadsheet.xlsx 文件，在其末尾追加一行数据，然后保存回原文件。

<?php

require 'vendor/autoload.php'; // 确保引入 Composer 自动加载文件

use PhpOffice\PhpSpreadsheet\IOFactory;
use PhpOffice\PhpSpreadsheet\Spreadsheet;

// 定义要操作的 Excel 文件路径
$filePath = 'yourspreadsheet.xlsx';

// ------------------- 步骤 1: 加载现有 Excel 文件 -------------------
$reader = IOFactory::createReader("Xlsx");
try {
    $spreadsheet = $reader->load($filePath);
    echo "文件 '{$filePath}' 已成功加载。\n";
} catch (\PhpOffice\PhpSpreadsheet\Reader\Exception $e) {
    die('加载 Excel 文件时发生错误: ' . $e->getMessage());
}

// ------------------- 步骤 2: 修改工作表数据 -------------------
$sheet = $spreadsheet->getActiveSheet();

// 获取当前工作表的最高行数
$last_row = (int) $sheet->getHighestRow();

// 计算新行的行号
$new_row = $last_row + 1;

// 在新行中设置数据
$sheet->setCellValue('A' . $new_row, "14");
$sheet->setCellValue('B' . $new_row, "Alina");
$sheet->setCellValue('C' . $new_row, "PG");
$sheet->setCellValue('D' . $new_row, "$32");
$sheet->setCellValue('E' . $new_row, "Pending");

echo "已在第 {$new_row} 行追加新数据。\n";

// ------------------- 步骤 3: 保存修改后的 Excel 文件 -------------------
$writer = IOFactory::createWriter($spreadsheet, "Xlsx");
try {
    $writer->save($filePath);
    echo "文件 '{$filePath}' 已成功保存。\n";
} catch (\PhpOffice\PhpSpreadsheet\Writer\Exception $e) {
    die('保存 Excel 文件时发生错误: ' . $e->getMessage());
}

?>

登录后复制

注意事项与最佳实践

错误处理： 在加载和保存文件时，务必使用 try-catch 块来捕获可能发生的 PhpOffice\PhpSpreadsheet\Reader\Exception 和 PhpOffice\PhpSpreadsheet\Writer\Exception。这有助于识别文件不存在、权限不足或文件损坏等问题。
文件路径与权限： 确保 PHP 脚本对目标 Excel 文件及其所在目录具有读写权限。文件路径应准确无误。
内存管理： 对于非常大的 Excel 文件（例如包含数万行或数十万行数据），直接加载到内存中可能会消耗大量内存。PHPSpreadsheet 提供了一些优化选项，如 setReadDataOnly(true) 来减少读取时的内存占用，或者考虑使用分批处理（chunk reading）和写入。
命名空间导入： 在脚本顶部使用 use 语句导入所需的类，例如 use PhpOffice\PhpSpreadsheet\IOFactory;，可以使代码更简洁易读。
备份： 在对重要文件进行修改之前，建议先创建一个备份，以防意外数据丢失。

总结

通过 PHPSpreadsheet 修改和保存现有 Excel 文件是一个常见且重要的操作。核心在于理解 IOFactory 在加载和写入过程中的作用。通过 IOFactory::createReader() 加载文件到 Spreadsheet 对象，然后对工作表进行操作，最后使用 IOFactory::createWriter() 将修改后的 Spreadsheet 对象保存回文件。遵循这些步骤并结合适当的错误处理，可以确保文件操作的稳定性和正确性，有效避免如 TypeError 等常见问题。

以上就是使用 PHPSpreadsheet 修改和保存现有 Excel 文件的完整指南的详细内容，更多请关注php中文网其它相关文章！