本教程详细指导如何使用 PHPSpreadsheet 库加载、修改并保存现有 Excel 文件。我们将涵盖通过 IOFactory 读取文件、访问工作表、更新单元格数据（包括追加新行），以及正确使用 IOFactory 写入修改后的文件。文章还将提供示例代码并强调常见错误及注意事项，确保您能顺利实现 Excel 文件的程序化更新。
引言
phpspreadsheet 是一个功能强大的 php 库，用于读取、写入和操作各种电子表格文件格式，包括 xlsx、xls 和 csv。在许多业务场景中，我们不仅需要生成新的 excel 文件，还需要对已有的文件进行修改，例如更新特定单元格、添加新行或调整数据。本教程将引导您完成使用 phpspreadsheet 修改和保存现有 excel 文件的整个过程。
准备工作
在开始之前，请确保您已通过 Composer 安装了 PHPSpreadsheet 库：
composer require phpoffice/phpspreadsheet
并在您的 PHP 脚本中引入必要的命名空间：
save($filePath); echo "文件 {$filePath} 不存在，已创建空文件。n";}?>
加载现有 Excel 文件
要修改一个现有的 Excel 文件，首先需要将其加载到 PHPSpreadsheet 对象中。推荐使用 IOFactory::createReader() 方法来根据文件类型创建合适的读取器，然后调用 load() 方法。
load($filePath); echo "文件 {$filePath} 加载成功。n";} catch (PhpOfficePhpSpreadsheetReaderException $e) { die('加载文件时发生错误: ' . $e->getMessage());}?>
修改或添加数据
加载文件后，您可以访问其中的工作表并对单元格进行操作。
立即学习“PHP免费学习笔记（深入）”；
1. 获取工作表
通常，我们会操作活动工作表，或者通过名称获取特定工作表：
getActiveSheet();// 或者通过名称获取特定工作表// $sheet = $spreadsheet->getSheetByName('Sheet1'); ?>
2. 设置单元格值
使用 setCellValue() 方法可以修改指定单元格的内容。
setCellValue('A1', '新的标题');// 修改 B2 单元格的值$sheet->setCellValue('B2', '更新的数据');?>
3. 追加新行数据
在现有数据下方添加新行是常见的需求。这可以通过获取当前工作表的最高行数，然后在此基础上增加一行来实现。
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() 方法。
save($filePath); echo "文件 {$filePath} 保存成功。n";} catch (PhpOfficePhpSpreadsheetWriterException $e) { die('保存文件时发生错误: ' . $e->getMessage());}?>
重要提示：关于 TypeError 的解释
在用户最初的尝试中，遇到了 Uncaught TypeError: Argument 1 passed to PhpOfficePhpSpreadsheetWriterXlsx::__construct() must be an instance of PhpOfficePhpSpreadsheetSpreadsheet, null given 错误。这通常是因为直接实例化 new Xlsx($spreadsheet) 时，$spreadsheet 变量在某个时刻为 null，或者在某些 PHPSpreadsheet 版本或特定配置下，直接实例化 Xlsx 类可能存在问题。
正确且推荐的做法是使用 IOFactory::createWriter($spreadsheet, “Xlsx”)。 IOFactory 会确保正确地创建并配置写入器实例，避免此类类型错误，并提供更强的兼容性和灵活性。
完整示例代码
以下是一个将加载、修改（包括追加新行）和保存操作整合在一起的完整示例：
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 (PhpOfficePhpSpreadsheetReaderException $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 (PhpOfficePhpSpreadsheetWriterException $e) { die('保存文件时发生错误: ' . $e->getMessage());}?>
注意事项
文件路径与权限： 确保 PHP 脚本对目标 Excel 文件及其所在目录具有读写权限。如果文件不存在，您可能需要先创建它（如示例所示）。文件锁定： 如果 Excel 文件正在被其他程序（如 Microsoft Excel）打开，PHPSpreadsheet 可能无法对其进行写入操作，导致保存失败。在生产环境中，应考虑文件锁定机制或告知用户关闭文件。内存消耗： 对于非常大的 Excel 文件（例如包含数十万行数据），一次性加载整个文件到内存可能会消耗大量内存。对于此类场景，PHPSpreadsheet 提供了高级功能，如分块读取和写入，以优化内存使用。错误处理： 在加载和保存文件时，务必使用 try-catch 块来捕获可能发生的异常，例如文件不存在、文件损坏或权限问题，并进行相应的错误处理。文件格式兼容性： IOFactory 能够根据文件扩展名自动识别文件格式，但为了明确和避免潜在问题，建议在 createReader() 和 createWriter() 中明确指定文件类型（如 “Xlsx”, “Xls”, “Csv”）。
总结
通过本教程，您应该已经掌握了使用 PHPSpreadsheet 库加载、修改和保存现有 Excel 文件的关键步骤。核心在于正确使用 IOFactory::createReader() 加载文件，操作 Spreadsheet 和 Worksheet 对象来修改数据，最后通过 IOFactory::createWriter() 将更改保存回文件。遵循这些指导和注意事项，将帮助您高效且稳定地进行 Excel 文件的程序化管理。
以上就是使用 PHPSpreadsheet 高效修改和保存现有 Excel 文件教程的详细内容，更多请关注php中文网其它相关文章！
版权声明：本文内容由互联网用户自发贡献，该文观点仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容， 请发送邮件至 chuangxiangniao@163.com 举报，一经查实，本站将立刻删除。
发布者：程序猿，转转请注明出处：https://www.chuangxiangniao.com/p/1293330.html
微信扫一扫 
支付宝扫一扫 
