phppresentation v0.10.x 不支持向母版（slidemaster）持久写入图片，因底层未实现 blip 和 p:pic 的序列化；推荐方案是每页调用 addslide() 后立即用 createpictureshape() 插入统一图片，或使用预置含嵌入图片的 powerpoint 模板。
PHP 用 PHPPresentation 修改母版图片会直接被忽略
PHPPresentation 当前（v0.10.x）不支持在母版（SlideMaster）中持久写入图片元素——你调用 addShape() 或 createPictureShape() 插入的图片，保存后不会出现在生成的 PPTX 母版里。这不是代码写错，是库底层没实现母版级图形渲染的序列化逻辑。
常见错误现象：
• 母版对象里能看到 PictureShape 实例，但打开导出文件，母版页空白
• 切换到普通幻灯片再插入同一张图，能正常显示
• 用 PowerPoint 手动编辑母版加图后，用 PHPPresentation 读取该文件，图片可读但无法新增
- 根本原因：PHPPresentation 把母版当作样式容器，只序列化字体、颜色、占位符位置等元信息，跳过
blip（图片二进制引用）和p:pic结构写入 - 替代思路：不碰母版，改用「每张幻灯片初始化时自动套用图层」的方式模拟模板效果
- 兼容性影响：PHPPresentation 对母版的支持长期停滞，官方 issue 区已有多个相关报告但无修复迹象
用 addSlide() + createPictureShape() 在每页插入统一背景图
这是目前最稳定、可控的“伪母版图片”方案：绕过母版限制，在创建每张新幻灯片时，立即在其底层插入相同尺寸/位置的图片，视觉上等效于母版背景。
使用场景：
• 企业 PPT 要求每页左上角固定 logo
• 培训材料每页底部带统一水印条
• 多页报告需统一顶部 banner 图
立即学习“PHP免费学习笔记（深入）”；
采用.NET CLR2.0、VS2005及SQL2000，前台页面使用用DIV+CSS开发；可以使用动态化运行，也可以采用全部静态化动作，甚至自己定义模板；后台信息编辑器采用最新版FCKeditor；产品信息可导出为EXCEL、WORD、PDF等格式存储；产品信息可以通过EXCEL模板批量导入；产品分类采用无限级分类；产品图片上传支持图片水印和文字水印，同时支持自动生成缩略图功能；电子邮件发送支持
- 必须在
$slide = $presentation->addSlide();后立刻插入图片，不能延后到循环外统一处理（否则只作用于最后一张） - 图片路径必须是绝对路径或相对于当前 PHP 脚本的可访问路径，
data://或远程 URL 不支持 - 推荐用
setOffsetX()/setOffsetY()精确控制位置，别依赖setHeight()/setWidth()自适应（PPTX 坐标系单位是 EMU，1 cm ≈ 360000 EMU）
$slide = $presentation->addSlide();
$logo = $slide->createPictureShape('/path/to/logo.png');
$logo->setOffsetX(180000)->setOffsetY(180000); // 左上角偏移 0.5cm
$logo->setWidth(1440000)->setHeight(720000); // 宽 4cm × 高 2cm
用 PowerPoint 手动建好母版图，PHP 只做内容填充
如果图片位置、尺寸、透明度要求严格（比如带阴影/裁剪/蒙版），别指望 PHP 库动态生成——直接在 PowerPoint 里做好母版，导出为 .pptx 模板，PHP 只负责用 PHPPresentation 或 PhpSpreadsheet 的 PresentationReader 加载它，再往占位符填文字/表格。
关键点：
• 母版里的图片必须是「嵌入」而非「链接」，否则 PHP 加载时会丢失
• 占位符要提前命名（如 title, content），PHP 才能用 getShapeByName() 定位
- 检查方式：在 PowerPoint 中右键母版图片 → “另存为图片”，能成功保存说明已嵌入
- 加载模板代码只需两行：
$objReader = IOFactory::createReader('PowerPoint2007');→$presentation = $objReader->load('template.pptx'); - 性能优势：比运行时逐页绘图快 3–5 倍，尤其处理 50+ 页文档时明显
别用 zipArchive 直接改 slideMaster1.xml
有人试过解压 PPTX、手动往 ppt/slideMasters/slideMaster1.xml 里塞 <pic></pic> 结构、再重打包——看似可行，但实际会触发 PowerPoint 打开校验失败，报错 PowerPoint found a problem with content in xxx.pptx。
根本卡点：
• PPTX 是 OPC 容器，图片二进制存在 media/ 子目录，XML 里只存关系 ID（r:id）
• 手动写 XML 无法自动生成匹配的 media/image1.png 和 _rels/slideMaster1.xml.rels 关联条目
- 哪怕你把图片文件也手动放进
media/，没有对应 rels 条目，PowerPoint 仍视其为损坏 - 生成 rels 文件需精确计算 SHA256 校验和并写入特定格式，PHPPresentation 内部用的是
ZipArchive::addEmptyDir()+addFromString()组合，手写极易出错 - 真要硬改，建议用
php-pptx这类专注 ZIP 层操作的库，而非自己拼 XML
