本文详细介绍了如何使用 PHPSpreadsheet 库加载、修改并保存现有 Excel 文件。我们将探讨正确的加载和写入流程，包括如何获取工作表、设置单元格值以及在现有数据后追加新行，并强调使用 IOFactory::createWriter 方法来避免常见错误，确保文件操作的稳定性和正确性。
PHPSpreadsheet 文件操作核心流程
使用 phpspreadsheet 对现有 excel 文件进行操作，通常遵循以下三个核心步骤：
加载现有文件： 将目标 Excel 文件读取到 PHPSpreadsheet 的 Spreadsheet 对象中。修改数据： 通过 Spreadsheet 对象访问特定的工作表和单元格，进行数据的添加、修改或删除。保存更改： 将修改后的 Spreadsheet 对象重新写入文件系统，覆盖或创建新的 Excel 文件。
正确加载现有 Excel 文件
要修改一个现有的 Excel 文件，首先需要将其加载到内存中。PHPSpreadsheet 提供了 IOFactory 类来简化这一过程，它能根据文件扩展名自动识别合适的读取器。
load($filePath);} catch (PhpOfficePhpSpreadsheetReaderException $e) { die('加载 Excel 文件时发生错误: ' . $e->getMessage());}// 至此，$spreadsheet 对象已包含 Excel 文件的所有数据echo "文件 '{$filePath}' 已成功加载。n";?>
说明：
IOFactory::createReader(“Xlsx”) 显式地创建了一个 XLSX 格式的读取器。这比直接使用 IOFactory::load($filePath) 更具控制性，尤其是在需要为读取器设置特定选项时。$reader->load($filePath) 将文件内容解析并存储在一个 PhpOfficePhpSpreadsheetSpreadsheet 类的实例中。
在工作表中进行数据修改
加载文件后，你可以通过 Spreadsheet 对象访问其包含的工作表，并对单元格数据进行操作。
获取活动工作表
通常，我们会对文件的活动工作表进行操作，或者通过索引/名称获取特定工作表。
立即学习“PHP免费学习笔记（深入）”；
// 获取当前活动的工作表$sheet = $spreadsheet->getActiveSheet();// 或者通过索引获取工作表 (0 代表第一个工作表)// $sheet = $spreadsheet->getSheet(0);// 或者通过名称获取工作表// $sheet = $spreadsheet->getSheetByName('Sheet1');
设置单元格值
使用 $sheet->setCellValue() 方法可以修改或设置指定单元格的值。
// 修改 A1 单元格的值$sheet->setCellValue('A1', '新的表头');
示例：在现有数据后追加新行
一个常见的需求是在现有数据的末尾追加新行。这可以通过获取当前工作表的最高行数，然后在其基础上加一来确定新行的位置。
// 获取当前工作表的最高行数$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() 方法来创建写入器对象，而不是直接实例化 PhpOfficePhpSpreadsheetWriterXlsx 等类。
为什么 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 (PhpOfficePhpSpreadsheetWriterException $e) { die('保存 Excel 文件时发生错误: ' . $e->getMessage());}
完整示例代码
以下是一个完整的 PHP 脚本，演示了如何加载现有 yourspreadsheet.xlsx 文件，在其末尾追加一行数据，然后保存回原文件。
load($filePath); echo "文件 '{$filePath}' 已成功加载。n";} catch (PhpOfficePhpSpreadsheetReaderException $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 (PhpOfficePhpSpreadsheetWriterException $e) { die('保存 Excel 文件时发生错误: ' . $e->getMessage());}?>
注意事项与最佳实践
错误处理： 在加载和保存文件时，务必使用 try-catch 块来捕获可能发生的 PhpOfficePhpSpreadsheetReaderException 和 PhpOfficePhpSpreadsheetWriterException。这有助于识别文件不存在、权限不足或文件损坏等问题。文件路径与权限： 确保 PHP 脚本对目标 Excel 文件及其所在目录具有读写权限。文件路径应准确无误。内存管理： 对于非常大的 Excel 文件（例如包含数万行或数十万行数据），直接加载到内存中可能会消耗大量内存。PHPSpreadsheet 提供了一些优化选项，如 setReadDataOnly(true) 来减少读取时的内存占用，或者考虑使用分批处理（chunk reading）和写入。命名空间导入： 在脚本顶部使用 use 语句导入所需的类，例如 use PhpOfficePhpSpreadsheetIOFactory;，可以使代码更简洁易读。备份： 在对重要文件进行修改之前，建议先创建一个备份，以防意外数据丢失。
总结
通过 PHPSpreadsheet 修改和保存现有 Excel 文件是一个常见且重要的操作。核心在于理解 IOFactory 在加载和写入过程中的作用。通过 IOFactory::createReader() 加载文件到 Spreadsheet 对象，然后对工作表进行操作，最后使用 IOFactory::createWriter() 将修改后的 Spreadsheet 对象保存回文件。遵循这些步骤并结合适当的错误处理，可以确保文件操作的稳定性和正确性，有效避免如 TypeError 等常见问题。
以上就是使用 PHPSpreadsheet 修改和保存现有 Excel 文件的完整指南的详细内容，更多请关注php中文网其它相关文章！
版权声明：本文内容由互联网用户自发贡献，该文观点仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容， 请发送邮件至 chuangxiangniao@163.com 举报，一经查实，本站将立刻删除。
发布者：程序猿，转转请注明出处：https://www.chuangxiangniao.com/p/1271660.html
微信扫一扫 
支付宝扫一扫 
