在日常开发中，我们经常需要对现有的excel文件进行数据更新、追加记录或格式调整。phpspreadsheet是一个功能强大且易于使用的php库，专门用于读写各种电子表格文件格式。本教程将引导您完成加载现有excel文件、修改其内容并将其保存回文件系统的完整过程。
1. 准备工作
在开始之前，请确保您的项目中已安装PHPSpreadsheet。您可以通过Composer进行安装：
composer require phpoffice/phpspreadsheet
2. 加载现有Excel文件
要修改一个现有的Excel文件，首先需要将其加载到PHPSpreadsheet的Spreadsheet对象中。推荐使用IOFactory来自动识别文件类型并创建相应的读取器（Reader）。
<?php
require 'vendor/autoload.php'; // 引入Composer自动加载文件
use PhpOffice\PhpSpreadsheet\IOFactory;
use PhpOffice\PhpSpreadsheet\Spreadsheet;
// 定义要操作的Excel文件路径
$filePath = 'yourspreadsheet.xlsx';
// 确保文件存在，否则IOFactory::load可能失败
if (!file_exists($filePath)) {
die("错误：文件 '{$filePath}' 不存在！请确保文件路径正确。");
}
try {
// 使用IOFactory创建读取器并加载Excel文件
// IOFactory::load() 方法可以自动根据文件扩展名选择合适的读取器
$spreadsheet = IOFactory::load($filePath);
echo "文件 '{$filePath}' 加载成功。\n";
} catch (\PhpOffice\PhpSpreadsheet\Reader\Exception $e) {
die("加载文件时发生错误：" . $e->getMessage());
}
// ... 后续操作注意事项：
- 务必在操作前引入vendor/autoload.php。
- IOFactory::load() 方法能够处理多种文件类型（如Xlsx, Xls, Csv等），无需手动指定Reader类型。
- 添加文件存在性检查和异常捕获，以提高代码的健壮性。
3. 修改电子表格内容
加载文件后，您可以获取工作表（Sheet）并进行各种修改操作，例如设置单元格值、追加新行等。
立即学习“PHP免费学习笔记（深入）”；
获取活动工作表
// 获取当前活动的工作表 $sheet = $spreadsheet->getActiveSheet(); echo "已获取活动工作表。\n";
设置特定单元格的值
您可以直接通过单元格坐标设置其值：
记录数据一键导出 Excel/CSV（带样式）
下载
把记录数组导出为带样式的 Excel(xlsx) 或带 BOM 的 CSV。支持列配置（表头/宽度/顺序）、表头冻结首行、斑马纹、布尔值转「是/否」、数组换行、CSV 中文防乱码。零依赖。触发词：导出 Excel、导出 CSV、记录转表格、列配置导出、数据导出、表格美化、JSON 转表格。
// 修改A1单元格的值
$sheet->setCellValue('A1', '新的标题');
echo "A1单元格已更新为 '新的标题'。\n";追加新数据行
在现有数据之后追加新行是常见的需求。这通常通过获取当前工作表的最高行数（getHighestRow()）来实现。
// 获取当前工作表的最高行数
$last_row = (int) $sheet->getHighestRow();
// 新行号为最高行数加1
$new_row = $last_row + 1;
echo "当前最高行数为 {$last_row}，新数据将写入第 {$new_row} 行。\n";
// 在新行中设置数据
$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";4. 保存修改后的文件
完成所有修改后，需要将Spreadsheet对象保存回文件系统。同样，推荐使用IOFactory::createWriter()来创建写入器（Writer）。
// ... （接上面的代码，在修改操作之后）
try {
// 使用IOFactory创建写入器，并指定文件类型（例如 "Xlsx"）
$writer = IOFactory::createWriter($spreadsheet, "Xlsx");
// 将修改后的电子表格保存回原文件，这将覆盖原文件
$writer->save($filePath);
echo "文件 '{$filePath}' 已成功保存并更新。\n";
} catch (\PhpOffice\PhpSpreadsheet\Writer\Exception $e) {
die("保存文件时发生错误：" . $e->getMessage());
}
?>注意事项：
- IOFactory::createWriter($spreadsheet, "Xlsx") 会根据第二个参数（文件类型字符串）自动创建正确的写入器。
- $writer->save($filePath) 会将修改后的内容写入到指定路径，如果文件已存在，则会覆盖它。如果您想保存为新文件，只需提供不同的文件路径即可。
- 确保PHP脚本对目标文件路径有写入权限。
5. 完整示例代码
以下是一个整合了加载、修改（包括追加数据）、保存的完整PHP代码示例：
<?php
require 'vendor/autoload.php'; // 引入Composer自动加载文件
use PhpOffice\PhpSpreadsheet\IOFactory;
use PhpOffice\PhpSpreadsheet\Spreadsheet;
// 定义要操作的Excel文件路径
$filePath = 'yourspreadsheet.xlsx'; // 确保此文件存在且可读写
// --- 步骤 1: 加载现有Excel文件 ---
if (!file_exists($filePath)) {
// 如果文件不存在，可以创建一个新的空Excel文件作为示例
echo "文件 '{$filePath}' 不存在，正在创建一个新的空文件作为示例。\n";
$newSpreadsheet = new Spreadsheet();
$newSpreadsheet->getActiveSheet()->setCellValue('A1', 'ID');
$newSpreadsheet->getActiveSheet()->setCellValue('B1', 'Name');
$newSpreadsheet->getActiveSheet()->setCellValue('C1', 'City');
$newSpreadsheet->getActiveSheet()->setCellValue('D1', 'Salary');
$newSpreadsheet->getActiveSheet()->setCellValue('E1', 'Status');
$writer = IOFactory::createWriter($newSpreadsheet, 'Xlsx');
$writer->save($filePath);
unset($newSpreadsheet); // 释放内存
echo "已创建初始文件 '{$filePath}'。\n";
}
try {
$spreadsheet = IOFactory::load($filePath);
echo "文件 '{$filePath}' 加载成功。\n";
} catch (\PhpOffice\PhpSpreadsheet\Reader\Exception $e) {
die("加载文件时发生错误：" . $e->getMessage());
}
// --- 步骤 2: 修改电子表格内容 ---
// 获取当前活动的工作表
$sheet = $spreadsheet->getActiveSheet();
echo "已获取活动工作表。\n";
// 示例1: 修改特定单元格 (如果A1是标题，可以修改它)
// $sheet->setCellValue('A1', '员工ID');
// echo "A1单元格已更新为 '员工ID'。\n";
// 示例2: 追加新数据行
$last_row = (int) $sheet->getHighestRow();
$new_row = $last_row + 1;
echo "当前最高行数为 {$last_row}，新数据将写入第 {$new_row} 行。\n";
$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";
// 您可以根据需要添加更多修改操作，例如：
// $sheet->setCellValue('F' . $new_row, date('Y-m-d H:i:s')); // 添加时间戳列
// $sheet->removeRow(2); // 删除第二行
// --- 步骤 3: 保存修改后的文件 ---
try {
$writer = IOFactory::createWriter($spreadsheet, "Xlsx");
$writer->save($filePath);
echo "文件 '{$filePath}' 已成功保存并更新。\n";
} catch (\PhpOffice\PhpSpreadsheet\Writer\Exception $e) {
die("保存文件时发生错误：" . $e->getMessage());
}
?>6. 注意事项与最佳实践
- 使用IOFactory: 始终优先使用IOFactory::load()和IOFactory::createWriter()。它们能够根据文件扩展名智能地选择正确的Reader和Writer，减少代码复杂性并提高兼容性。直接实例化new PhpOffice\PhpSpreadsheet\Writer\Xlsx()等类容易因命名空间或参数错误导致TypeError。
- 错误处理: 务必添加try-catch块来捕获文件操作可能抛出的异常（如文件不存在、无权限、文件损坏等），这对于生产环境中的应用程序至关重要。
- 文件权限: 确保PHP运行用户对目标Excel文件及其所在目录拥有读取和写入权限。
- 内存管理: 对于非常大的Excel文件，加载整个文件到内存可能会消耗大量资源。PHPSpreadsheet提供了Reader和Writer的内存优化选项（如setReadDataOnly、setLoadSheetsOnly），以及分块读取/写入（Chunk Reading/Writing）功能，以处理大型文件。
- 命名空间: 确保正确使用use语句引入所需的类，或者使用完全限定的类名（如\PhpOffice\PhpSpreadsheet\IOFactory::load()）。
通过遵循本教程的步骤和最佳实践，您将能够高效且稳定地使用PHPSpreadsheet来修改和管理您的Excel文件。
