引言
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 (\PhpOffice\PhpSpreadsheet\Reader\Exception $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 (\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 会确保正确地创建并配置写入器实例，避免此类类型错误，并提供更强的兼容性和灵活性。
完整示例代码
以下是一个将加载、修改（包括追加新行）和保存操作整合在一起的完整示例：
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());
}
?>注意事项
- 文件路径与权限： 确保 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 文件的程序化管理。
