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

Clickable
Clickable

用AI在几秒钟内生成广告

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

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

WorkBuddy
WorkBuddy

腾讯云推出的AI原生桌面智能体工作台

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
js 字符串转数组
js 字符串转数组

js字符串转数组的方法:1、使用“split()”方法;2、使用“Array.from()”方法;3、使用for循环遍历;4、使用“Array.split()”方法。本专题为大家提供js字符串转数组的相关的文章、下载、课程内容,供大家免费下载体验。

760

2023.08.03

js截取字符串的方法
js截取字符串的方法

js截取字符串的方法有substring()方法、substr()方法、slice()方法、split()方法和slice()方法。本专题为大家提供字符串相关的文章、下载、课程内容,供大家免费下载体验。

221

2023.09.04

java基础知识汇总
java基础知识汇总

java基础知识有Java的历史和特点、Java的开发环境、Java的基本数据类型、变量和常量、运算符和表达式、控制语句、数组和字符串等等知识点。想要知道更多关于java基础知识的朋友,请阅读本专题下面的的有关文章,欢迎大家来php中文网学习。

1567

2023.10.24

字符串介绍
字符串介绍

字符串是一种数据类型,它可以是任何文本,包括字母、数字、符号等。字符串可以由不同的字符组成,例如空格、标点符号、数字等。在编程中,字符串通常用引号括起来,如单引号、双引号或反引号。想了解更多字符串的相关内容,可以阅读本专题下面的文章。

649

2023.11.24

java读取文件转成字符串的方法
java读取文件转成字符串的方法

Java8引入了新的文件I/O API,使用java.nio.file.Files类读取文件内容更加方便。对于较旧版本的Java,可以使用java.io.FileReader和java.io.BufferedReader来读取文件。在这些方法中,你需要将文件路径替换为你的实际文件路径,并且可能需要处理可能的IOException异常。想了解更多java的相关内容,可以阅读本专题下面的文章。

1228

2024.03.22

php中定义字符串的方式
php中定义字符串的方式

php中定义字符串的方式:单引号;双引号;heredoc语法等等。想了解更多字符串的相关内容,可以阅读本专题下面的文章。

1204

2024.04.29

go语言字符串相关教程
go语言字符串相关教程

本专题整合了go语言字符串相关教程,阅读专题下面的文章了解更多详细内容。

193

2025.07.29

c++字符串相关教程
c++字符串相关教程

本专题整合了c++字符串相关教程,阅读专题下面的文章了解更多详细内容。

131

2025.08.07

Python异步编程与Asyncio高并发应用实践
Python异步编程与Asyncio高并发应用实践

本专题围绕 Python 异步编程模型展开,深入讲解 Asyncio 框架的核心原理与应用实践。内容包括事件循环机制、协程任务调度、异步 IO 处理以及并发任务管理策略。通过构建高并发网络请求与异步数据处理案例,帮助开发者掌握 Python 在高并发场景中的高效开发方法,并提升系统资源利用率与整体运行性能。

37

2026.03.12

热门下载

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

精品课程

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

共137课时 | 13.4万人学习

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

共6课时 | 11.3万人学习

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

共13课时 | 1.0万人学习

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

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