PHPPresentation 是生成带图片PPTX的可靠方案，需先 addMedia() 注册图片再 setMedia() 引用，注意路径UTF-8编码、尺寸设置及比例缩放，避免文件损坏或图片不显示。
用 PHPPresentation 创建带图片的 PPT，不是靠 file_put_contents 拼 XML
PHP 原生不支持生成 PPTX，硬写 OPC 包结构极易出错——你看到的“空白幻灯片”“文件损坏”“无法打开”，八成是跳过了 ZIP 容器校验或关系文件（[Content_Types].xml、_rels/.rels）没配对。必须用专注 Office Open XML 的库，PHPPresentation（phpoffice/phppresentation）是目前最稳的选择，它把图片嵌入、布局、字体这些脏活全包了。
别碰 PowerPoint COM 扩展（Windows-only）、也别试 php-pptx 这类半成品——它们要么不维护，要么图片路径解析错乱，尤其在 Linux 下相对路径根本找不到图。
addImageSlide() 之前，图片必须先 addMedia()
直接传路径给幻灯片方法会失败，因为 PPTX 要求所有外部资源（图片、音频）先注册进媒体池，再通过 ID 引用。漏掉这步，图片不会显示，也不报错，只留个空占位框。
-
$media = $objPHPPresentation->addMedia('path/to/photo.jpg');返回一个Media对象，含唯一 ID - 创建幻灯片后，用
$shape = $slide->createDrawingShape();，再调$shape->setMedia($media); - 务必设尺寸：
$shape->setWidth(400); $shape->setHeight(300);，否则默认 0×0，看不见 - 支持格式：
.jpg、.png、.gif；.webp不行，Office 兼容性差
中文路径或中文文件名图片会报 ZipArchive::addFile(): File not found
这是 PHPPresentation 底层用 ZipArchive 打包时，对非 ASCII 字符路径处理失败。不是你的图丢了，是 PHP 没法按原样读取。
立即学习“PHP免费学习笔记（深入）”；
- 解决方案：用
realpath()+mb_convert_encoding()转为 UTF-8 编码路径：mb_convert_encoding(realpath('素材/图标.png'), 'UTF-8', 'auto') - 更稳妥：把图片先
copy()到临时目录，用纯英文名（如img_123.png），再传给addMedia() - 别依赖
$_SERVER['DOCUMENT_ROOT']拼路径——CLI 和 Web 环境下值不同，容易静默失败
导出后图片模糊？检查 setResizeProportional(false) 和原始分辨率
PPTX 不存储像素密度，只存宽高值。如果原始图是 800×600，但你在代码里设 setWidth(800) + setHeight(600)，Office 会按屏幕 DPI 渲染，可能拉伸失真。
- 保持比例：调
$shape->setResizeProportional(true)，再只设宽或高一项（比如setWidth(400)），高自动算 - 高清需求：原始图至少 2× 目标尺寸（如要 400px 宽，提供 800px 宽的图），PPTX 会缩放但保留细节
- 避免 PNG 透明通道干扰：某些旧版 Office 渲染带 alpha 的 PNG 会有灰边，可提前用 GD 或 Imagick 去透明转白底
图片嵌入逻辑比想象中敏感——路径编码、媒体注册顺序、尺寸设定，三者错一个，就只剩一个打不开的文件或一张黑图。别省那几行 addMedia() 和 setResizeProportional()。
