PHP读取PPTX模板必须用PHPPresentation而非PHPWord或PHPExcel，因其专为PPTX的ZIP+XML结构设计，支持图片占位符、形状等精准操作；需用0.10.x稳定版，设唯一名称定位图片，替换时传本地绝对路径并调用removeUnusedImages()清理冗余。
PHP 读取 PPTX 模板必须用 PHPPresentation，不是 PHPWord 或 PHPExcel
很多人一上来就搜“PHP 替换 PPT 图片”，结果引入 PHPWord 或老版 PHPExcel，完全跑偏——PPTX 是 ZIP+XML 结构，和 DOCX/XLSX 的 OPC 封装逻辑不同，PHPPresentation 是目前唯一能稳定解析/修改 PPTX 内容（含图片占位符、形状、文本框）的 PHP 库。
注意：PHPPresentation 不维护了，但 0.10.x 版本仍可工作；别用它的 dev-main 分支，里面大量 DOMDocument 调用在 PHP 8.1+ 会报 Deprecated: DOMDocument::schemaValidate(): Passing null to parameter #1 ($filename) of type string is deprecated 错误。
- 安装命令固定为：
composer require phpoffice/phppresentation:~0.10.0 - 模板必须是 .pptx（不能是 .ppt），且图片占位符得是「插入 → 图片 → 占位符」或「插入 → 形状 → 填充为图片」，纯文本框里贴图不识别
- 它不支持修改母版页里的图片，只处理幻灯片级内容
getSlide()->getShapeByIndex() 找不到图片？试试 getShapeByUniqueName() 或遍历 getShapes()
PPTX 导出时会重命名所有 shape ID，getShapeByIndex(0) 看似简单，但索引不稳定：加个文本框、删个动画都可能让图片 shape 下标偏移。更可靠的方式是给图片占位符手动设唯一名称：
在 PowerPoint 中右键图片占位符 →「设置图片格式」→「属性」→「名称」栏填 avatar_img 或 chart_2024（不能含空格/特殊字符）→ 保存模板。
立即学习“PHP免费学习笔记（深入）”；
- 代码中用
$shape = $slide->getShapeByUniqueName('avatar_img');精准定位 - 如果没提前命名，只能遍历：
foreach ($slide->getShapes() as $shape) { if ($shape instanceof \PhpOffice\PhpPresentation\Shape\Picture) { ... } } - 注意：
getShapes()返回的是全部 shape（含文本框、线条），必须用instanceof过滤，否则替换会失败且无报错
替换图片必须用 setPath() + 本地文件路径，不能传 URL 或 base64
PHPPresentation 的 Picture 对象不接受远程 URL 或 data URI，$shape->setPath('https://...') 看似合理，实际会静默失败，导出后仍是原图。
正确流程是：先将新图片下载或写入临时目录，再传绝对路径。
- 路径必须是服务器本地绝对路径，例如：
/var/www/tmp/uploaded_chart.png，相对路径如./images/new.png会报File not found - 图片格式需与原占位符一致（原图是 PNG，新图也得是 PNG），否则可能渲染异常或被忽略
- 记得检查 PHP 进程有无该路径读写权限，常见坑：
open_basedir restriction in effect或Permission denied
导出前调用 removeUnusedImages()，否则旧图残留、体积暴增
每次调用 $shape->setPath()，PHPPresentation 都会把新图作为独立资源塞进 PPTX ZIP 包，但不会自动清理原图——导致最终文件里堆满历史图片，体积翻几倍，甚至触发 Office 打开报错 PowerPoint found a problem with content。
必须在 $objWriter->save(...) 前补这一句：
$presentation->removeUnusedImages();
- 这行不能漏，也没有替代方案；
removeUnusedImages()是唯一清理机制 - 如果模板里有多个图片占位符，且只替换其中几个，未替换的图片仍会被保留，这是正常行为
- 导出后建议用
zipinfo output.pptx | grep -i ".png\|.jpg"检查资源数是否合理
批量替换的核心其实是「精准定位 + 本地路径 + 清理冗余」，三步缺一不可。最容易卡住的是路径权限和 shape 名称没设对，而不是语法或库本身。
