0

0

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

DDD

DDD

发布时间:2025-11-04 14:18:01

|

659人浏览过

|

来源于php中文网

原创

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()方法将其所有样式属性导出为一个关联数组。这个数组包含了字体、填充、边框、对齐等所有样式信息。

BibiGPT-哔哔终结者
BibiGPT-哔哔终结者

B站视频总结器-一键总结 音视频内容

下载
$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:

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文件操作的灵活性和准确性。

相关专题

更多
php文件怎么打开
php文件怎么打开

打开php文件步骤:1、选择文本编辑器;2、在选择的文本编辑器中,创建一个新的文件,并将其保存为.php文件;3、在创建的PHP文件中,编写PHP代码;4、要在本地计算机上运行PHP文件,需要设置一个服务器环境;5、安装服务器环境后,需要将PHP文件放入服务器目录中;6、一旦将PHP文件放入服务器目录中,就可以通过浏览器来运行它。

2409

2023.09.01

php怎么取出数组的前几个元素
php怎么取出数组的前几个元素

取出php数组的前几个元素的方法有使用array_slice()函数、使用array_splice()函数、使用循环遍历、使用array_slice()函数和array_values()函数等。本专题为大家提供php数组相关的文章、下载、课程内容,供大家免费下载体验。

1553

2023.10.11

php反序列化失败怎么办
php反序列化失败怎么办

php反序列化失败的解决办法检查序列化数据。检查类定义、检查错误日志、更新PHP版本和应用安全措施等。本专题为大家提供php反序列化相关的文章、下载、课程内容,供大家免费下载体验。

1449

2023.10.11

php怎么连接mssql数据库
php怎么连接mssql数据库

连接方法:1、通过mssql_系列函数;2、通过sqlsrv_系列函数;3、通过odbc方式连接;4、通过PDO方式;5、通过COM方式连接。想了解php怎么连接mssql数据库的详细内容,可以访问下面的文章。

951

2023.10.23

php连接mssql数据库的方法
php连接mssql数据库的方法

php连接mssql数据库的方法有使用PHP的MSSQL扩展、使用PDO等。想了解更多php连接mssql数据库相关内容,可以阅读本专题下面的文章。

1414

2023.10.23

html怎么上传
html怎么上传

html通过使用HTML表单、JavaScript和PHP上传。更多关于html的问题详细请看本专题下面的文章。php中文网欢迎大家前来学习。

1233

2023.11.03

PHP出现乱码怎么解决
PHP出现乱码怎么解决

PHP出现乱码可以通过修改PHP文件头部的字符编码设置、检查PHP文件的编码格式、检查数据库连接设置和检查HTML页面的字符编码设置来解决。更多关于php乱码的问题详情请看本专题下面的文章。php中文网欢迎大家前来学习。

1445

2023.11.09

php文件怎么在手机上打开
php文件怎么在手机上打开

php文件在手机上打开需要在手机上搭建一个能够运行php的服务器环境,并将php文件上传到服务器上。再在手机上的浏览器中输入服务器的IP地址或域名,加上php文件的路径,即可打开php文件并查看其内容。更多关于php相关问题,详情请看本专题下面的文章。php中文网欢迎大家前来学习。

1305

2023.11.13

Java 项目构建与依赖管理(Maven / Gradle)
Java 项目构建与依赖管理(Maven / Gradle)

本专题系统讲解 Java 项目构建与依赖管理的完整体系,重点覆盖 Maven 与 Gradle 的核心概念、项目生命周期、依赖冲突解决、多模块项目管理、构建加速与版本发布规范。通过真实项目结构示例,帮助学习者掌握 从零搭建、维护到发布 Java 工程的标准化流程,提升在实际团队开发中的工程能力与协作效率。

3

2026.01.12

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
PHP课程
PHP课程

共137课时 | 8.5万人学习

JavaScript ES5基础线上课程教学
JavaScript ES5基础线上课程教学

共6课时 | 6.9万人学习

PHP新手语法线上课程教学
PHP新手语法线上课程教学

共13课时 | 0.8万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号