使用PHPSpreadsheet更新模板时保留嵌入式对象与SmartArt的方法

我之前也踩过这个坑！PHPSpreadsheet默认的加载和写入逻辑并不完整支持Office Excel里的所有非单元格内容，比如嵌入式图表、SmartArt这类对象很容易被丢弃——毕竟它的核心定位是处理表格数据，对复杂Office对象的支持有局限。下面给你几个可行的解决方案：

1. 启用图表加载与写入选项 #

如果你的模板主要包含嵌入式图表，先试试明确开启图表支持，这能帮你保留大部分图表内容：

// 初始化Reader并配置加载选项
$reader = \PhpOffice\PhpSpreadsheet\IOFactory::createReader('Xlsx');
$reader->setIncludeCharts(true); // 强制加载嵌入式图表
$reader->setLoadAllSheets(); // 加载模板中所有工作表（避免遗漏）

$spreadsheet = $reader->load("ExcelTemplates/template.xlsx");

// 修改目标单元格
$spreadsheet->getActiveSheet()->setCellValue('A1', 'New headline');

// 初始化Writer并配置写入选项
$writer = \PhpOffice\PhpSpreadsheet\IOFactory::createWriter($spreadsheet, 'Xlsx');
$writer->setIncludeCharts(true); // 写入时保留图表
$writer->save("ExcelOutput/generatedFile.xlsx");

2. 针对SmartArt的特殊处理 #

遗憾的是，PHPSpreadsheet目前对SmartArt的支持非常有限——因为SmartArt是Office专属的XML结构化图形，PHPSpreadsheet无法完整解析和重建它。如果你的模板依赖SmartArt，推荐用「先复制模板再修改」的方式：

// 先复制原始模板到输出目录（完全保留所有原始内容）
copy("ExcelTemplates/template.xlsx", "ExcelOutput/generatedFile.xlsx");

// 打开复制后的文件进行修改
$spreadsheet = \PhpOffice\PhpSpreadsheet\IOFactory::load("ExcelOutput/generatedFile.xlsx");
$spreadsheet->getActiveSheet()->setCellValue('A1', 'New headline');

// 写入修改（此时只更新单元格数据，其他原始内容不受影响）
$writer = \PhpOffice\PhpSpreadsheet\IOFactory::createWriter($spreadsheet, 'Xlsx');
$writer->save("ExcelOutput/generatedFile.xlsx");

这种方法利用了PHPSpreadsheet只修改变更内容的特性，原始模板里的SmartArt、嵌入式对象都会被完整保留——毕竟我们是在复制的完整模板基础上做修改，而不是从无到有重建文件。

3. 极端场景：直接操作XLSX压缩包 #

如果上面的方法还是有问题，你可以直接用PHP的ZipArchive操作XLSX文件（本质是ZIP压缩包），只修改存储单元格数据的XML文件，完全不触动其他内容。这种方法需要你对XLSX的内部结构有一定了解，适合对精度要求极高的场景：

$zip = new ZipArchive();
if ($zip->open("ExcelTemplates/template.xlsx") === true) {
    // 复制模板内容到临时目录
    $zip->extractTo("temp_xlsx_dir");
    $zip->close();

    // 这里需要手动解析并修改对应的工作表XML文件（比如xl/worksheets/sheet1.xml）
    // 逻辑相对复杂，需要熟悉XLSX的内部XML结构

    // 重新打包成新的XLSX文件
    $newZip = new ZipArchive();
    $newZip->open("ExcelOutput/generatedFile.xlsx", ZipArchive::CREATE);
    // 遍历临时目录下的所有文件添加到压缩包
    $files = new RecursiveIteratorIterator(new RecursiveDirectoryIterator("temp_xlsx_dir"));
    foreach ($files as $file) {
        if (!$file->isDir()) {
            $filePath = $file->getRealPath();
            $relativePath = substr($filePath, strlen("temp_xlsx_dir") + 1);
            $newZip->addFile($filePath, $relativePath);
        }
    }
    $newZip->close();

    // 清理临时目录
    array_map('unlink', glob("temp_xlsx_dir/*"));
    rmdir("temp_xlsx_dir");
}

不过这个方法成本较高，除非必要不推荐使用。

总结一下：如果只是保留图表，用方法1；如果有SmartArt，优先用方法2；极端情况再考虑方法3。

内容的提问来源于stack exchange，提问作者Sondre