0

0

PHPSpreadsheet 保存时丢失工作表中的图片与形状的解决方案

聖光之護

聖光之護

发布时间:2026-02-02 17:21:03

|

414人浏览过

|

来源于php中文网

原创

PHPSpreadsheet 保存时丢失工作表中的图片与形状的解决方案

phpspreadsheet 在读取并重新保存含图片或形状的 excel 文件时,常导致特定工作表(如 sheet2)中的图形元素丢失;根本原因在于其不完全支持 office open xml 中的绘图层(drawingml)结构,且写入过程为“重建式”而非“透传式”。

PHPSpreadsheet 并非“无损编辑器”,而是一个以数据和公式处理为核心的功能库。当它读取 .xlsx 文件时,会解析核心内容(单元格值、样式、公式、工作表结构等),但对 DrawingML(即图片、形状、文本框、图表等可视化对象)的支持非常有限

  • ✅ 支持读取部分嵌入图片(如 Worksheet::getDrawingCollection() 可获取 PhpOffice\PhpSpreadsheet\Worksheet\Drawing 对象);
  • ⚠️ 但不支持读取/保存形状(Shapes)、SmartArt、组合对象、带文本框的批注图形、以及跨工作表的绘图容器(如 xl/drawings/drawing2.xml 中的 Sheet2 专属绘图)
  • ❌ setOffice2003Compatibility(true) 实际上会进一步禁用现代绘图特性,加剧图形丢失;
  • ❌ setPreCalculateFormulas(false) 与图形保存无关,可安全移除。

正确做法:仅在必要时操作图形,且需显式保留

若原始文件中图片位于 Sheet2,应主动遍历并重写该工作表的绘图集合:

Reword
Reword

AI文章写作,一个会思考的编辑

下载
use PhpOffice\PhpSpreadsheet\IOFactory;
use PhpOffice\PhpSpreadsheet\Worksheet\Drawing;

$spreadsheet = IOFactory::load($origin_file);
$sheet = $spreadsheet->getSheetByName('Sheet2'); // 显式定位目标工作表

// 尝试读取现有图片(注意:仅支持简单图片,不支持形状)
$drawingCollection = $sheet->getDrawingCollection();
foreach ($drawingCollection as $drawing) {
    if ($drawing instanceof Drawing) {
        // 可选:调整位置或大小后重新注册(否则可能因坐标偏移失效)
        $drawing->setWorksheet($sheet); // 确保归属正确
    }
}

// 保存 —— 移除兼容性模式,启用完整 Open XML 支持
$writer = IOFactory::createWriter($spreadsheet, 'Xlsx');
$writer->setPreCalculateFormulas(false); // 可保留,但非必需
// ❌ 删除这一行:$writer->setOffice2003Compatibility(true);
$writer->save($new_file);

关键注意事项

  • 形状(Shapes)无法通过 PHPExcel/PHPSpreadsheet 保留:包括自选图形、流程图、线条、艺术字等均属于 xl/drawings/drawing*.xml 中的 元素,当前 PHPSpreadsheet(v2.2+)完全不解析也不写入此类节点
  • 替代方案建议
    • 若需严格保真,改用 Apache POI(Java)openpyxl(Python)(后者对绘图支持更完善);
    • 或采用「模板填充」策略:将图片/形状预置于 Excel 模板中,仅用 PHPSpreadsheet 填充数据,避免调用 save() 触发重写;
  • 验证方式解压 .xlsx 为 ZIP,对比 xl/drawings/ 目录下 drawing1.xml(Sheet1)与 drawing2.xml(Sheet2)是否在新文件中被生成——若缺失,即确认为库限制。

总之,这不是代码疏漏,而是 PHPSpreadsheet 的设计边界。面对图形密集型报表,请优先评估工具适用性,而非强行适配。

相关文章

PHP速学教程(入门到精通)
PHP速学教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

热门AI工具

更多
DeepSeek
DeepSeek

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

豆包大模型
豆包大模型

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

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

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

文心一言
文心一言

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

讯飞写作
讯飞写作

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

即梦AI
即梦AI

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

ChatGPT
ChatGPT

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

相关专题

更多
pdf怎么转换成xml格式
pdf怎么转换成xml格式

将 pdf 转换为 xml 的方法:1. 使用在线转换器;2. 使用桌面软件(如 adobe acrobat、itext);3. 使用命令行工具(如 pdftoxml)。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

1905

2024.04.01

xml怎么变成word
xml怎么变成word

步骤:1. 导入 xml 文件;2. 选择 xml 结构;3. 映射 xml 元素到 word 元素;4. 生成 word 文档。提示:确保 xml 文件结构良好,并预览 word 文档以验证转换是否成功。想了解更多xml的相关内容,可以阅读本专题下面的文章。

2094

2024.08.01

xml是什么格式的文件
xml是什么格式的文件

xml是一种纯文本格式的文件。xml指的是可扩展标记语言,标准通用标记语言的子集,是一种用于标记电子文件使其具有结构性的标记语言。想了解更多相关的内容,可阅读本专题下面的相关文章。

1089

2024.11.28

apache是什么意思
apache是什么意思

Apache是Apache HTTP Server的简称,是一个开源的Web服务器软件。是目前全球使用最广泛的Web服务器软件之一,由Apache软件基金会开发和维护,Apache具有稳定、安全和高性能的特点,得益于其成熟的开发和广泛的应用实践,被广泛用于托管网站、搭建Web应用程序、构建Web服务和代理等场景。本专题为大家提供了Apache相关的各种文章、以及下载和课程,希望对各位有所帮助。

411

2023.08.23

apache启动失败
apache启动失败

Apache启动失败可能有多种原因。需要检查日志文件、检查配置文件等等。想了解更多apache启动的相关内容,可以阅读本专题下面的文章。

931

2024.01.16

excel对比两列数据异同
excel对比两列数据异同

Excel作为数据的小型载体,在日常工作中经常会遇到需要核对两列数据的情况,本专题为大家提供excel对比两列数据异同相关的文章,大家可以免费体验。

1403

2023.07.25

excel重复项筛选标色
excel重复项筛选标色

excel的重复项筛选标色功能使我们能够快速找到和处理数据中的重复值。本专题为大家提供excel重复项筛选标色的相关的文章、下载、课程内容,供大家免费下载体验。

411

2023.07.31

excel复制表格怎么复制出来和原来一样大
excel复制表格怎么复制出来和原来一样大

本专题为大家带来excel复制表格怎么复制出来和原来一样大相关文章,帮助大家解决问题。

564

2023.08.02

AO3官网入口与中文阅读设置 AO3网页版使用与访问
AO3官网入口与中文阅读设置 AO3网页版使用与访问

本专题围绕 Archive of Our Own(AO3)官网入口展开,系统整理 AO3 最新可用官网地址、网页版访问方式、正确打开链接的方法,并详细讲解 AO3 中文界面设置、阅读语言切换及基础使用流程,帮助用户稳定访问 AO3 官网,高效完成中文阅读与作品浏览。

45

2026.02.02

热门下载

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

精品课程

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

共137课时 | 10.8万人学习

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

共6课时 | 11.2万人学习

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

共13课时 | 0.9万人学习

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

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