使用 PHPSpreadsheet 高效修改和保存现有 Excel 文件教程

composer require phpoffice/phpspreadsheet

<?php

require 'vendor/autoload.php';

use PhpOffice\PhpSpreadsheet\IOFactory;
use PhpOffice\PhpSpreadsheet\Spreadsheet;
use PhpOffice\PhpSpreadsheet\Writer\Xlsx;

// 假设您的 Excel 文件名为 'yourspreadsheet.xlsx'
$filePath = 'yourspreadsheet.xlsx';

// 确保文件存在，否则创建它（可选，根据需求）
if (!file_exists($filePath)) {
    $spreadsheet = new Spreadsheet();
    $writer = new Xlsx($spreadsheet);
    $writer->save($filePath);
    echo "文件 {$filePath} 不存在，已创建空文件。\n";
}

?>

<?php
// ... (之前的准备工作和命名空间引入)

try {
    // 创建一个读取器对象，根据文件类型（例如 "Xlsx"）
    $reader = IOFactory::createReader("Xlsx");

    // 加载指定的 Excel 文件
    $spreadsheet = $reader->load($filePath);

    echo "文件 {$filePath} 加载成功。\n";

} catch (\PhpOffice\PhpSpreadsheet\Reader\Exception $e) {
    die('加载文件时发生错误: ' . $e->getMessage());
}
?>

<?php
// ... (加载文件后的代码)

// 获取当前活动的工作表
$sheet = $spreadsheet->getActiveSheet();

// 或者通过名称获取特定工作表
// $sheet = $spreadsheet->getSheetByName('Sheet1'); 
?>

<?php
// ... (获取工作表后的代码)

// 修改 A1 单元格的值
$sheet->setCellValue('A1', '新的标题');

// 修改 B2 单元格的值
$sheet->setCellValue('B2', '更新的数据');
?>

<?php
// ... (获取工作表后的代码)

// 获取当前工作表的最高行数
$lastRow = (int) $sheet->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";
?>

<?php
// ... (修改或添加数据后的代码)

try {
    // 创建一个写入器对象，根据文件类型（例如 "Xlsx"）
    // 注意：这里需要传入 $spreadsheet 对象
    $writer = IOFactory::createWriter($spreadsheet, "Xlsx");

    // 将修改后的 Spreadsheet 对象保存到文件，覆盖原有文件
    $writer->save($filePath);

    echo "文件 {$filePath} 保存成功。\n";

} catch (\PhpOffice\PhpSpreadsheet\Writer\Exception $e) {
    die('保存文件时发生错误: ' . $e->getMessage());
}
?>

<?php

require 'vendor/autoload.php';

use PhpOffice\PhpSpreadsheet\IOFactory;
use PhpOffice\PhpSpreadsheet\Spreadsheet;
use PhpOffice\PhpSpreadsheet\Writer\Xlsx;

$filePath = 'yourspreadsheet.xlsx'; // 确保此文件存在或被创建

// --- 确保文件存在（如果不存在则创建空文件） ---
if (!file_exists($filePath)) {
    $spreadsheet = new Spreadsheet();
    $writer = new Xlsx($spreadsheet);
    $writer->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());
}

?>