PHP 用 PHPPresentation 修改母版时图片占位符不显示
母版里加了 PictureShape，生成 PPTX 后打开却看不到——不是代码没执行，是占位符被母版的「隐藏占位符」逻辑吞掉了。PHPPresentation 默认把母版里的图形当“装饰”，不暴露为可编辑占位符；必须手动设 setPlaceholderId() 并指定类型，否则 PowerPoint 根本不认它是占位符。
- 母版中添加图片占位符，必须调用
setPlaceholderId(10)（10是图片占位符固定 ID，不是任意数） - 同时要调用
setPlaceholderType(\PhpOffice\PhpPresentation\Slide\Placeholder\Type::PICTURE)，否则即使 ID 对了，PPT 也当普通图形处理 - 位置尺寸用
setOffsetX()/setOffsetY()和setWidth()/setHeight()设置，别依赖母版网格自动对齐——PHPPresentation 不解析母版参考线
批量向多个母版页插入相同图片占位符的循环写法
一个主题常含多个母版（如 slideMaster.xml 里有 title、content、section 等不同母版），直接遍历 $presentation->getSlideMasters() 就行，但要注意：每个母版的占位符 ID 必须唯一，不能全用 10 —— PowerPoint 会冲突或只认第一个。
- 给每个母版分配独立 ID：比如第一个母版用
10，第二个用11，第三个用12，对应 PowerPoint 占位符 ID 规范（图片类从10起递增） - 插入前先清空母版原有占位符：调用
$master->getPlaceholders()->clear()，避免旧占位符残留干扰新布局 - 占位符名称（
setName()）建议带母版索引，如"img-placeholder-master-0"，方便后期调试时定位来源
PHPPresentation 生成的 PPTX 在 Office 365 打开后占位符无法替换图片
不是代码问题，是 PHPPresentation 写入的 p:ph XML 节点缺少 sz="full" 或 idx="0" 属性，导致 Office 认为这不是标准内容占位符，禁用右键「更改图片」菜单。
- 必须显式设置
setIndex(0)（哪怕只有一个占位符），否则 Office 忽略该占位符的交互能力 - 调用
setSize(\PhpOffice\PhpPresentation\Slide\Placeholder\Size::FULL)，对应 XML 中sz="full"，这是触发「可替换图片」的关键标记 - 绕过 bug 的临时方案：生成后用 ZIP 工具打开 PPTX，手动编辑
slideMaster1.xml里对应p:ph节点，补上idx="0" sz="full"—— 验证过有效
为什么用 addPictureShape() 而不用 addMediaShape()
addMediaShape() 本质是嵌入视频/音频对象，它生成的 XML 是 p:media，PowerPoint 不识别为图片占位符；只有 addPictureShape() 产出 p:pic + 正确 p:ph 包裹结构，才能被当作占位符。
立即学习“PHP免费学习笔记（深入）”；
-
addPictureShape()返回的是PictureShape实例，后续才能链式调用setPlaceholderId()和setPlaceholderType() - 如果误用
addMediaShape()，即使强行塞进母版，导出后在 PowerPoint 里右键只有「编辑媒体」选项，没有「更改图片」 - 注意：
PictureShape构造时传的图片路径只是占位用（可为空），真正图片是在用户编辑 PPTX 时由 PowerPoint 加载的，所以路径合法性不影响母版生成
idx 和 sz 这两个属性，文档里几乎不提，但缺一不可。 
