PHPSpreadsheet：复制单元格值及其格式的完整指南

本教程详细介绍了如何使用PHPSpreadsheet库复制Excel单元格的值及其完整格式（包括样式）。通过分离值和样式获取，并分别应用到目标单元格，确保源单元格的字体、背景色等视觉效果得以精确迁移。文章提供了清晰的示例代码和操作步骤，帮助开发者有效处理Excel数据复制需求。

在使用PHPSpreadsheet处理Excel文件时，开发者经常会遇到需要将一个单元格的内容及其所有格式（如背景色、字体颜色、边框、对齐方式等）复制到另一个单元格的需求。然而，简单地使用 getCell()->getValue() 或 getCell()->getFormattedValue() 方法，只能获取并复制单元格的文本或计算值，而无法保留其视觉样式。这是因为这些方法关注的是数据本身，而非其表现形式。

核心概念：值与样式的分离复制

PHPSpreadsheet在设计上将单元格的“值”和“样式”视为两个独立但相关联的实体。要实现完整的单元格复制，我们需要：

1. 获取单元格的值： 使用 getValue() 方法。
2. 提取单元格的样式： 通过 getStyle('CELL_ADDRESS')->exportArray() 方法将源单元格的全部样式属性导出为一个关联数组。
3. 应用样式： 将导出的样式数组通过 getStyle('TARGET_CELL_ADDRESS')->applyFromArray($styleArray) 方法应用到目标单元格。

这种分离处理机制确保了数据和格式都能被精确控制和迁移。

实现步骤与示例代码

下面将通过一个具体的示例来演示如何使用PHPSpreadsheet复制单元格的值及其格式。假设我们有一个名为 test.xlsx 的Excel文件，其中单元格 J5 包含一个值和特定的背景色、字体颜色等格式。我们的目标是将 J5 的值和格式复制到 C2 单元格。

1. 准备环境

首先，确保你的PHP项目已安装PHPSpreadsheet库。如果尚未安装，可以通过Composer进行安装：

composer require phpoffice/phpspreadsheet

2. 编写PHP代码

getSheet(0); // 获取第一个工作表

// 步骤2: 获取源单元格 (J5) 的值
$sourceCellValue = $sheet->getCell("J5")->getValue();

// 步骤3: 提取源单元格 (J5) 的样式
// exportArray() 方法会将所有样式属性（字体、填充、边框等）导出为一个数组
$sourceCellStyleArray = $sheet->getStyle('J5')->exportArray();

// 步骤4: 将值设置到目标单元格 (C2)
// 注意：这里使用 'C2' 作为目标单元格地址
$sheet->setCellValue('C2', $sourceCellValue);

// 步骤5: 将样式应用到目标单元格 (C2)
// applyFromArray() 方法将之前导出的样式数组应用到目标单元格
$sheet->getStyle('C2')->applyFromArray($sourceCellStyleArray);

// 步骤6: 保存修改后的Excel文件
// 将结果保存为 test_result.xlsx
$oWriter = IOFactory::createWriter($spreadsheet, 'Xlsx');
$oWriter->save("test_result.xlsx");

echo "单元格 J5 的值和格式已成功复制到 C2，并保存为 test_result.xlsx\n";

// 释放内存
$spreadsheet->disconnectWorksheets();
unset($spreadsheet);
?>

代码解析：

• IOFactory::load("test.xlsx"): 加载现有的Excel文件。
• $sheet->getCell("J5")->getValue(): 获取 J5 单元格的原始值。
• $sheet->getStyle('J5')->exportArray(): 这是复制格式的关键。它返回一个包含 J5 单元格所有样式属性（如字体、填充、边框、对齐等）的关联数组。
• $sheet->setCellValue('C2', $sourceCellValue): 将获取到的值设置到目标单元格 C2。
• $sheet->getStyle('C2')->applyFromArray($sourceCellStyleArray): 将之前从 J5 导出的样式数组应用到 C2 单元格，从而实现格式的复制。
• IOFactory::createWriter($spreadsheet, 'Xlsx') 和 $oWriter->save("test_result.xlsx"): 将修改后的 Spreadsheet 对象保存为新的Excel文件。

注意事项

• 样式覆盖： applyFromArray() 方法会覆盖目标单元格原有的样式。如果目标单元格已经有部分样式，并且你只想合并而非完全覆盖，可能需要更复杂的逻辑，例如先获取目标单元格样式，再合并数组。
• 批量复制： 如果需要复制多个单元格，可以将上述步骤封装到循环中，遍历源单元格范围并逐一处理。
• 性能考量： 对于非常大的Excel文件和大量的单元格操作，频繁地读取和写入样式可能会影响性能。在处理大量数据时，考虑优化逻辑，例如一次性读取所有源样式，然后批量应用。
• getFormattedValue() 的作用： getFormattedValue() 主要用于获取单元格显示出来的值，例如日期格式化后的字符串，或者带有货币符号的数值。它不涉及单元格的视觉样式（如背景色、字体颜色等），因此不能用于复制格式。
• 源文件格式丢失问题： 原始问题中提到，在某些情况下源文件 J5 的格式会消失。这通常不会发生在 IOFactory::load 和 save 的过程中，除非在保存之前对 J5 进行了修改。上述解决方案仅针对目标单元格 C2 进行操作，不会影响源单元格 J5 的格式。

总结

通过PHPSpreadsheet复制单元格的值和格式，需要理解其“值”和“样式”分离处理的机制。核心在于使用 getStyle('CELL_ADDRESS')->exportArray() 提取源单元格的样式，然后通过 getStyle('TARGET_CELL_ADDRESS')->applyFromArray($styleArray) 将样式应用到目标单元格。掌握这一方法，可以帮助开发者灵活高效地处理Excel数据和格式的复制需求，实现更复杂的报表生成和数据处理任务。