php无法直接插入powerpoint原生“图片画廊”布局，只能通过phppresentation手动排版多图模拟：统一缩放、精确计算emu坐标、校验路径与尺寸，或使用含占位符的模板+cloneslide替换。
PHP 生成 PPT 时无法直接插入「图片画廊布局」
PowerPoint 原生的「图片画廊」是一种内置版式（如 Picture Gallery），它依赖 PowerPoint 客户端的 UI 渲染逻辑，不是简单堆叠图片——PHP 没有办法通过 PHPPresentation 或 PhpSpreadsheet 触发该布局。所谓“创建画廊”，实际只能手动模拟视觉效果。
用 PHPPresentation 手动排版多图实现画廊感
主流方案是用 PHPPresentation 手动添加多个 Shape（图片形状），控制位置、缩放和间距。关键不是调用某个函数，而是按比例计算坐标 + 统一裁剪/缩放策略。
-
addImageSlide()只能加单张图；必须用createDrawingShape()逐个添加，并手动设置setOffsetX()/setOffsetY() - 推荐统一将所有原图缩放到相同高度（如
120像素），再按行排列：每行最多 4 张，水平间距30，垂直间距20 - 注意：
PHPPresentation不自动保持宽高比，必须显式调用setResizeProportional(true)，否则图片会拉伸变形 - 路径必须是绝对路径或 Web 可访问路径（
file://协议在部分环境不生效，优先用__DIR__ . '/images/photo1.jpg'）
常见错误：图片错位、不显示、导出后空白
这些问题几乎都源于坐标单位理解偏差或资源路径失效，而非代码逻辑错误。
- PHPPresentation 使用「EMU」（English Metric Units）作坐标单位：
1 cm ≈ 360000 EMU，别直接写100当像素用；建议封装一个pxToEmu($px)函数（return (int) round($px * 12700);） - 图片文件不存在时，
PHPPresentation不报错，只静默跳过——务必用file_exists()提前校验 - 如果导出 PPTX 后图片显示为「X」图标，大概率是路径含中文、空格或相对路径未解析成功；改用
realpath()并检查getimagesize()是否返回有效尺寸 - 避免在循环中反复调用
addSlide()；一张幻灯片够用就别拆，否则动画/版式易混乱
替代思路：用 PowerPoint 模板 + 占位符批量填充
比纯代码排版更可靠的方式，是提前在 PowerPoint 中建好「画廊页」模板：插入 8 个内容占位符（Content Placeholder），命名成 img_1、img_2…，然后用 PHPPresentation 的 cloneSlide() 和 replaceText() 替换占位符图片。
立即学习“PHP免费学习笔记（深入）”；
- 需启用
setUseDiskCache(true)避免内存溢出（尤其图片多时） - 替换图片本质是覆盖
slide.xml中的r:embed引用，所以模板里占位符必须是「图片类型」，不能是文本框 - 这个方法绕过了坐标计算，但要求模板文件稳定——每次更新模板后要重新测试占位符索引是否偏移
真正难的不是加几张图，而是让不同尺寸的原始图片在固定区域内对齐、不裁切关键内容、且在各种 PowerPoint 版本里显示一致。手动排版要算坐标，模板法要管版本兼容，没有银弹。
