PHPSpreadsheet修改保存Excel教程

在日常开发中，我们经常需要对现有的Excel文件进行数据更新、追加记录或格式调整。PHPSpreadsheet是一个功能强大且易于使用的PHP库，专门用于读写各种电子表格文件格式。本教程将引导您完成加载现有Excel文件、修改其内容并将其保存回文件系统的完整过程。

1. 准备工作

在开始之前，请确保您的项目中已安装PHPSpreadsheet。您可以通过Composer进行安装：

composer require phpoffice/phpspreadsheet

2. 加载现有Excel文件

要修改一个现有的Excel文件，首先需要将其加载到PHPSpreadsheet的Spreadsheet对象中。推荐使用IOFactory来自动识别文件类型并创建相应的读取器（Reader）。

getMessage());
}

// ... 后续操作

注意事项：

• 务必在操作前引入vendor/autoload.php。
• IOFactory::load() 方法能够处理多种文件类型（如Xlsx, Xls, Csv等），无需手动指定Reader类型。
• 添加文件存在性检查和异常捕获，以提高代码的健壮性。

3. 修改电子表格内容

加载文件后，您可以获取工作表（Sheet）并进行各种修改操作，例如设置单元格值、追加新行等。

获取活动工作表

// 获取当前活动的工作表
$sheet = $spreadsheet->getActiveSheet();
echo "已获取活动工作表。\n";

设置特定单元格的值

您可以直接通过单元格坐标设置其值：

// 修改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代码示例：

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文件。