PHPSpreadsheet：复制Excel单元格内容与样式的教程-php教程-PHP中文网

PHPSpreadsheet：复制Excel单元格内容与样式的教程

DDD

发布： 2025-11-04 14:18:01

原创

627人浏览过

PHPSpreadsheet：复制Excel单元格内容与样式的教程

phpspreadsheet复制单元格时，直接获取值的方法无法保留样式。本教程详细介绍了如何通过分离值和样式处理，先获取源单元格的样式数组，再将其应用到目标单元格，从而实现单元格内容及其格式的完整复制。

引言

在使用PHPSpreadsheet处理Excel文件时，开发者常常需要将一个单元格的内容连同其格式（如背景色、字体颜色、边框等）一起复制到另一个单元格。然而，仅仅使用getCell()->getValue()或getCell()->getFormattedValue()等方法，只能复制单元格的数据本身，而无法保留其视觉样式。本文将详细阐述如何在PHPSpreadsheet中正确地实现单元格值与格式的完整复制。

核心原理：分离值与样式处理

PHPSpreadsheet将单元格的数据内容和其样式（Style）视为两个相对独立的实体。因此，要完整复制一个单元格，需要分两步操作：首先获取源单元格的数据，然后获取其所有样式属性，最后分别将数据和样式应用到目标单元格。

实现步骤

以下是使用PHPSpreadsheet复制单元格值和格式的详细步骤：

1. 加载工作簿

首先，你需要加载一个现有的Excel文件。

立即学习“PHP免费学习笔记（深入）”；

require 'vendor/autoload.php';
use PhpOffice\PhpSpreadsheet\Spreadsheet;
use PhpOffice\PhpSpreadsheet\IOFactory;

// 加载现有Excel文件
$spreadsheet = \PhpOffice\PhpSpreadsheet\IOFactory::load("test.xlsx");
$sheet = $spreadsheet->getSheet(0); // 获取第一个工作表

登录后复制

2. 获取源单元格的值

通过getCell()方法获取源单元格对象，并使用getValue()获取其原始数据。

$sourceCellAddress = 'J5'; // 源单元格地址，例如J5
$cellValue = $sheet->getCell($sourceCellAddress)->getValue();

登录后复制

3. 提取源单元格的样式

这是实现格式复制的关键一步。使用getStyle('单元格地址')获取该单元格的样式对象，然后调用exportArray()方法将其所有样式属性导出为一个关联数组。这个数组包含了字体、填充、边框、对齐等所有样式信息。

腾讯混元3D

腾讯推出的一站式3D内容创作平台

240

查看详情

$styleArray = $sheet->getStyle($sourceCellAddress)->exportArray();

登录后复制

4. 将值设置到目标单元格

使用setCellValue()或setCellValueByColumnAndRow()方法将获取到的值设置到目标单元格。

$targetCellAddress = 'C2'; // 目标单元格地址，例如C2
$sheet->setCellValue($targetCellAddress, $cellValue);
// 或者，如果你更喜欢使用列号和行号：
// $sheet->setCellValueByColumnAndRow(3, 2, $cellValue); // C列是第3列，2是行号

登录后复制

5. 将样式应用到目标单元格

同样使用getStyle('目标单元格地址')获取目标单元格的样式对象，然后调用applyFromArray($styleArray)方法，将之前导出的样式数组应用到目标单元格。

$sheet->getStyle($targetCellAddress)->applyFromArray($styleArray);

登录后复制

6. 保存修改后的工作簿

最后，使用IOFactory::createWriter()创建写入器，并保存修改后的文件。

$oWriter = IOFactory::createWriter($spreadsheet, 'Xlsx');
$oWriter->save("test_result.xlsx");

登录后复制

完整示例代码

结合上述步骤，以下是一个完整的PHP代码示例，演示如何将单元格J5的值和格式复制到单元格C2：

<?php
require 'vendor/autoload.php'; // 引入Composer自动加载文件
use PhpOffice\PhpSpreadsheet\Spreadsheet;
use PhpOffice\PhpSpreadsheet\IOFactory;

// 1. 加载现有Excel文件 (假设文件名为 test.xlsx 存在于当前目录)
$spreadsheet = \PhpOffice\PhpSpreadsheet\IOFactory::load("test.xlsx");
$sheet = $spreadsheet->getSheet(0); // 获取第一个工作表

// 定义源单元格和目标单元格地址
$sourceCellAddress = 'J5';
$targetCellAddress = 'C2';

// 2. 获取源单元格的值
$cellValue = $sheet->getCell($sourceCellAddress)->getValue();

// 3. 提取源单元格的样式
// exportArray() 方法将单元格的所有样式属性导出为一个关联数组
$styleArray = $sheet->getStyle($sourceCellAddress)->exportArray();

// 4. 将值设置到目标单元格
$sheet->setCellValue($targetCellAddress, $cellValue);

// 5. 将样式应用到目标单元格
// applyFromArray() 方法将一个样式数组应用到目标单元格
$sheet->getStyle($targetCellAddress)->applyFromArray($styleArray);

// 6. 保存修改后的工作簿
$oWriter = IOFactory::createWriter($spreadsheet, 'Xlsx');
$oWriter->save("test_result.xlsx");

echo "单元格 " . $sourceCellAddress . " 的值和格式已成功复制到 " . $targetCellAddress . "，并保存为 test_result.xlsx";
?>

登录后复制

注意事项

getFormattedValue() 的用途： getFormattedValue() 方法返回的是单元格按照其格式规则（如日期格式、货币格式、百分比等）显示出来的字符串值，而不是其原始数据值。它主要用于获取单元格的“显示文本”，但不包含任何视觉样式信息，因此不能用于复制样式。
源文件格式丢失问题： 原始问题中提到在某些尝试下，源单元格J5的格式会消失。本教程提供的方法是先读取样式，再应用到目标单元格，不会直接修改源单元格的样式。因此，只要在保存前没有对源单元格进行不当操作，源单元格的格式不会丢失。
批量复制： 如果需要批量复制多个单元格，可以将上述逻辑封装在循环中。对于大范围的单元格，PHPSpreadsheet也支持对一个范围（如A1:B10）应用样式，这在某些情况下可以提高效率。
样式数组的结构： exportArray()生成的样式数组非常详细，包含font、fill、borders、alignment等多个子数组。如果只需要复制部分样式（例如，只复制背景色而不复制字体），可以手动修改或筛选$styleArray，只保留你需要的样式属性。

总结

通过PHPSpreadsheet复制单元格内容及其格式，核心在于理解数据与样式的分离处理。利用getValue()获取数据，结合getStyle()->exportArray()提取样式数组，再通过setCellValue()和getStyle()->applyFromArray()分别将数据和样式应用到目标单元格，即可实现完整的复制功能。掌握这一技巧，能有效提升使用PHPSpreadsheet进行Excel文件操作的灵活性和准确性。

以上就是PHPSpreadsheet：复制Excel单元格内容与样式的教程的详细内容，更多请关注php中文网其它相关文章！