讲师中心 微信公众号
AI工具推荐 视频效率加速

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

雨涛同学_6009

雨涛同学_6009

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

|

454人浏览过

|

来源于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,应主动遍历并重写该工作表的绘图集合:

python学习
python学习

Python 编程学习助手 skill,面向零基础用户。 当用户表达以下意图时触发: - 学习 Python 基础概念(变量、数据类型、循环、函数、类等) - 请求 Python 练习题或测验 - 请求审查或调试 Python 代码 - 请求 Python 项目实战指导(爬虫、数据分析、Web 开发等入门项目) - 泛化表述如"教我 Python""我想学编程""Python 怎么写""帮我学 Python" 此 skill

下载
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服务平台。

讯飞绘文

讯飞绘文是一款由科大讯飞推出的一站式 AIGC 内容运营平台。

AionClaw
AionClaw Hot

AionClaw是一款面向办公、创作和编程任务的AI桌面智能体。

墨刀AI
墨刀AI Hot

一款AI图像与设计工具,主要用于产品经理的专属智能体,适合需要提升相关任务效率的用户。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

PixPix
PixPix Hot

PixPix是一款面向电商视觉生产的AI商品图生成工具。

音述AI
音述AI Hot

一款AI音频处理工具,主要用于音述AI是一个以“用声音述说故事”为核心的 AI 音乐创作与声音分享社区,适合需要提升相关任务效率的用户。

相关专题

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

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

4724

2024.04.01

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

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

6137

2024.08.01

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

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

2522

2024.11.28

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

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

5561

2023.07.25

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

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

3476

2023.07.31

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

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

3260

2023.08.02

excel表格斜线一分为二
excel表格斜线一分为二

在Excel表格中,我们可以使用斜线将单元格一分为二。本专题为大家带来excel表格斜线一分为二怎么弄的相关文章,希望可以帮到大家。

1444

2023.08.02

excel斜线表头一分为二
excel斜线表头一分为二

excel斜线表头一分为二的方法有使用合并单元格功能方法、使用文本框功能方法、使用自定义格式方法。本专题为大家提供excel斜线表头一分为二相关的各种文章、以及下载和课程。

717

2023.08.02

Gradle插件开发入门教程
Gradle插件开发入门教程

本专题介绍Gradle插件开发的基本流程,涵盖插件类编写、自定义任务注册、扩展参数设计和插件应用方法,帮助你理解插件如何组织构建逻辑,减少多个项目之间的重复配置。

100

2026.10.22

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
墨刀帮助中心
墨刀帮助中心

共0课时 | 0人学习

MyEclipse学习中心
MyEclipse学习中心

共0课时 | 0人学习

Apache Subversion 官方手册
Apache Subversion 官方手册

共0课时 | 0人学习

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

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn