PHPSpreadsheet快速修改Excel教程

从现在开始，努力学习吧！本文《PHPSpreadsheet高效修改Excel教程》主要讲解了等等相关知识点，我会在golang学习网中持续更新相关的系列文章，欢迎大家关注并积极留言建议。下面就先一起来看一下本篇正文内容吧，希望能帮到你！

本教程详细指导如何使用 PHPSpreadsheet 库加载、修改并保存现有 Excel 文件。我们将涵盖通过 IOFactory 读取文件、访问工作表、更新单元格数据（包括追加新行），以及正确使用 IOFactory 写入修改后的文件。文章还将提供示例代码并强调常见错误及注意事项，确保您能顺利实现 Excel 文件的程序化更新。

引言

PHPSpreadsheet 是一个功能强大的 PHP 库，用于读取、写入和操作各种电子表格文件格式，包括 XLSX、XLS 和 CSV。在许多业务场景中，我们不仅需要生成新的 Excel 文件，还需要对已有的文件进行修改，例如更新特定单元格、添加新行或调整数据。本教程将引导您完成使用 PHPSpreadsheet 修改和保存现有 Excel 文件的整个过程。

准备工作

在开始之前，请确保您已通过 Composer 安装了 PHPSpreadsheet 库：

composer require phpoffice/phpspreadsheet

并在您的 PHP 脚本中引入必要的命名空间：

<?php

require 'vendor/autoload.php';

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

// 假设您的 Excel 文件名为 'yourspreadsheet.xlsx'
$filePath = 'yourspreadsheet.xlsx';

// 确保文件存在，否则创建它（可选，根据需求）
if (!file_exists($filePath)) {
    $spreadsheet = new Spreadsheet();
    $writer = new Xlsx($spreadsheet);
    $writer->save($filePath);
    echo "文件 {$filePath} 不存在，已创建空文件。\n";
}

?>

加载现有 Excel 文件

要修改一个现有的 Excel 文件，首先需要将其加载到 PHPSpreadsheet 对象中。推荐使用 IOFactory::createReader() 方法来根据文件类型创建合适的读取器，然后调用 load() 方法。

<?php
// ... (之前的准备工作和命名空间引入)

try {
    // 创建一个读取器对象，根据文件类型（例如 "Xlsx"）
    $reader = IOFactory::createReader("Xlsx");

    // 加载指定的 Excel 文件
    $spreadsheet = $reader->load($filePath);

    echo "文件 {$filePath} 加载成功。\n";

} catch (\PhpOffice\PhpSpreadsheet\Reader\Exception $e) {
    die('加载文件时发生错误: ' . $e->getMessage());
}
?>

修改或添加数据

加载文件后，您可以访问其中的工作表并对单元格进行操作。

1. 获取工作表

通常，我们会操作活动工作表，或者通过名称获取特定工作表：

<?php
// ... (加载文件后的代码)

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

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

2. 设置单元格值

使用 setCellValue() 方法可以修改指定单元格的内容。

<?php
// ... (获取工作表后的代码)

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

// 修改 B2 单元格的值
$sheet->setCellValue('B2', '更新的数据');
?>

3. 追加新行数据

在现有数据下方添加新行是常见的需求。这可以通过获取当前工作表的最高行数，然后在此基础上增加一行来实现。

<?php
// ... (获取工作表后的代码)

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

// 计算新行的行号
$newRow = $lastRow + 1;

// 在新行中设置多个单元格的值
$sheet->setCellValue('A' . $newRow, '数据1');
$sheet->setCellValue('B' . $newRow, '数据2');
$sheet->setCellValue('C' . $newRow, '数据3');
$sheet->setCellValue('D' . $newRow, '数据4');
$sheet->setCellValue('E' . $newRow, '数据5');

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

保存修改后的 Excel 文件

完成所有修改后，您需要将 Spreadsheet 对象写回文件系统。与加载文件类似，推荐使用 IOFactory::createWriter() 方法创建写入器，然后调用 save() 方法。

<?php
// ... (修改或添加数据后的代码)

try {
    // 创建一个写入器对象，根据文件类型（例如 "Xlsx"）
    // 注意：这里需要传入 $spreadsheet 对象
    $writer = IOFactory::createWriter($spreadsheet, "Xlsx");

    // 将修改后的 Spreadsheet 对象保存到文件，覆盖原有文件
    $writer->save($filePath);

    echo "文件 {$filePath} 保存成功。\n";

} catch (\PhpOffice\PhpSpreadsheet\Writer\Exception $e) {
    die('保存文件时发生错误: ' . $e->getMessage());
}
?>

重要提示：关于 TypeError 的解释

在用户最初的尝试中，遇到了 Uncaught TypeError: Argument 1 passed to PhpOffice\PhpSpreadsheet\Writer\Xlsx::__construct() must be an instance of PhpOffice\PhpSpreadsheet\Spreadsheet, null given 错误。这通常是因为直接实例化 new Xlsx($spreadsheet) 时，$spreadsheet 变量在某个时刻为 null，或者在某些 PHPSpreadsheet 版本或特定配置下，直接实例化 Xlsx 类可能存在问题。

正确且推荐的做法是使用 IOFactory::createWriter($spreadsheet, "Xlsx")。 IOFactory 会确保正确地创建并配置写入器实例，避免此类类型错误，并提供更强的兼容性和灵活性。

完整示例代码

以下是一个将加载、修改（包括追加新行）和保存操作整合在一起的完整示例：

<?php

require 'vendor/autoload.php';

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

$filePath = 'yourspreadsheet.xlsx'; // 确保此文件存在或被创建

// --- 确保文件存在（如果不存在则创建空文件） ---
if (!file_exists($filePath)) {
    $spreadsheet = new Spreadsheet();
    $writer = new Xlsx($spreadsheet);
    $writer->save($filePath);
    echo "文件 {$filePath} 不存在，已创建空文件。\n";
    // 如果是新建的空文件，可以写入一个表头
    $sheet = $spreadsheet->getActiveSheet();
    $sheet->setCellValue('A1', 'ID');
    $sheet->setCellValue('B1', '姓名');
    $sheet->setCellValue('C1', '城市');
    $sheet->setCellValue('D1', '薪资');
    $sheet->setCellValue('E1', '状态');
    $writer->save($filePath); // 保存初始表头
    echo "已为新文件写入初始表头。\n";
}

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

// --- 2. 获取工作表并修改/添加数据 ---
$sheet = $spreadsheet->getActiveSheet();

// 示例1: 修改特定单元格
$sheet->setCellValue('A1', '用户ID'); // 假设A1是标题，这里修改它
echo "已修改 A1 单元格为 '用户ID'。\n";

// 示例2: 追加新行数据
$lastRow = (int) $sheet->getHighestRow();
$newRow = $lastRow + 1;

$sheet->setCellValue('A' . $newRow, '1001');
$sheet->setCellValue('B' . $newRow, '张三');
$sheet->setCellValue('C' . $newRow, '北京');
$sheet->setCellValue('D' . $newRow, '$5000');
$sheet->setCellValue('E' . $newRow, '已完成');

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

// 示例3: 再次追加一行数据
$newRow++;
$sheet->setCellValue('A' . $newRow, '1002');
$sheet->setCellValue('B' . $newRow, '李四');
$sheet->setCellValue('C' . $newRow, '上海');
$sheet->setCellValue('D' . $newRow, '$6000');
$sheet->setCellValue('E' . $newRow, '待处理');
echo "已在第 {$newRow} 行追加第二条新数据。\n";


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

?>

注意事项

1. 文件路径与权限： 确保 PHP 脚本对目标 Excel 文件及其所在目录具有读写权限。如果文件不存在，您可能需要先创建它（如示例所示）。
2. 文件锁定： 如果 Excel 文件正在被其他程序（如 Microsoft Excel）打开，PHPSpreadsheet 可能无法对其进行写入操作，导致保存失败。在生产环境中，应考虑文件锁定机制或告知用户关闭文件。
3. 内存消耗： 对于非常大的 Excel 文件（例如包含数十万行数据），一次性加载整个文件到内存可能会消耗大量内存。对于此类场景，PHPSpreadsheet 提供了高级功能，如分块读取和写入，以优化内存使用。
4. 错误处理： 在加载和保存文件时，务必使用 try-catch 块来捕获可能发生的异常，例如文件不存在、文件损坏或权限问题，并进行相应的错误处理。
5. 文件格式兼容性： IOFactory 能够根据文件扩展名自动识别文件格式，但为了明确和避免潜在问题，建议在 createReader() 和 createWriter() 中明确指定文件类型（如 "Xlsx", "Xls", "Csv"）。

总结

通过本教程，您应该已经掌握了使用 PHPSpreadsheet 库加载、修改和保存现有 Excel 文件的关键步骤。核心在于正确使用 IOFactory::createReader() 加载文件，操作 Spreadsheet 和 Worksheet 对象来修改数据，最后通过 IOFactory::createWriter() 将更改保存回文件。遵循这些指导和注意事项，将帮助您高效且稳定地进行 Excel 文件的程序化管理。

文中关于的知识介绍，希望对你的学习有所帮助！若是受益匪浅，那就动动鼠标收藏这篇《PHPSpreadsheet快速修改Excel教程》文章吧，也可关注golang学习网公众号了解相关技术文章。