PHPSpreadsheet 文件操作核心流程
使用 phpspreadsheet 对现有 excel 文件进行操作，通常遵循以下三个核心步骤：
- 加载现有文件： 将目标 Excel 文件读取到 PHPSpreadsheet 的 Spreadsheet 对象中。
- 修改数据： 通过 Spreadsheet 对象访问特定的工作表和单元格，进行数据的添加、修改或删除。
- 保存更改： 将修改后的 Spreadsheet 对象重新写入文件系统，覆盖或创建新的 Excel 文件。
正确加载现有 Excel 文件
要修改一个现有的 Excel 文件，首先需要将其加载到内存中。PHPSpreadsheet 提供了 IOFactory 类来简化这一过程，它能根据文件扩展名自动识别合适的读取器。
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', '新的表头');示例：在现有数据后追加新行
一个常见的需求是在现有数据的末尾追加新行。这可以通过获取当前工作表的最高行数，然后在其基础上加一来确定新行的位置。
// 获取当前工作表的最高行数
$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 文件，在其末尾追加一行数据，然后保存回原文件。
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 等常见问题。
