phppresentation 替换 ppt 图片占位符需遍历幻灯片形状，通过 getname() 匹配占位符名定位 pictureshape，再用 setimageresource(file_get_contents()) 设置二进制内容；png 需避免 alpha 预乘，jpeg 用 rgb 模式；替换后须 refreshslide() 并用 iofactory::createwriter() 保存。
PHP 用 PhpPresentation 替换 PPT 占位符图片失败的典型表现
直接调用 setMediaFile() 或 setImageResource() 后图片没更新，甚至报错 Call to a member function getSlide() on null——根本原因是占位符（PictureShape）在模板里不是“独立对象”，而是嵌套在 TextElement 或 Shape 容器里的子元素，直接找 getShapeById() 通常找不到。
必须先定位到真实 PictureShape 实例再替换
模板中图片占位符本质是 PictureShape 对象，但它往往藏在幻灯片的形状列表里，且 ID 不一定和你在 PowerPoint 里看到的“名称”一致。不能靠猜测 ID，得遍历 + 判断。
- 用
$slide->getShapes()拿到所有形状，逐个检查是否是PictureShape类型 - 用
$shape->getName()匹配你预设的占位符名（比如"logo_img"），而不是依赖 ID - 确认是目标后，再调用
$shape->setImageResource(<code>file_get_contents($newImgPath)) - 注意：
setImageResource()接收的是二进制内容，不是路径；file_get_contents()必须成功，否则会静默失败
PhpPresentation 对 PNG/JPEG 的兼容性差异
不是所有图片都能正常写入。实测发现：PNG（尤其带透明通道）容易在导出后变黑块，JPEG 更稳；但如果你硬要用 PNG，得确保它不含 alpha 预乘（premultiplied alpha），否则 PhpPresentation 解码时会错乱。
- 用
getimagesize()+imagecreatefrompng()先验证 PNG 是否可读，避免后续静默失败 - JPEG 尽量用 RGB 模式（别用 CMYK），否则部分版本会报
Unsupported image type - 图片尺寸建议控制在 2000px 以内，过大会导致内存溢出或生成 PPT 打不开
批量替换时务必重置幻灯片缓存并显式保存
改完多个图片后不生效？大概率是 PhpPresentation 内部缓存了原始幻灯片结构，或者你漏掉了关键步骤。
立即学习 “PHP 免费学习笔记（深入）”；
- 每替换一张图后，调用
$presentation->refreshSlide($slide)强制刷新该幻灯片状态 - 全部处理完，必须用
$objWriter = IOFactory::createWriter($presentation, 'PowerPoint2007')，再$objWriter->save($outputPath) - 别用
file_put_contents()直接写二进制流——它绕过IOFactory的压缩和关系修复，生成的 PPT 多数打不开 - 输出路径要确保目录存在且有写权限，否则报错信息是
failed to open stream，但实际是权限问题
