用 PHPPresentation 批量插入图片到指定幻灯片
PHP 本身不原生支持 PPT 编辑，得靠第三方库；PHPPresentation（来自 PHPOffice）是目前最稳定、文档相对清晰的选项。它不依赖 COM 或 LibreOffice，纯 PHP 实现，适合服务器端批量处理。
关键点：不能直接“编辑”已有的 PPTX 幻灯片内容（比如在第 3 页图上叠一张新图），而是要「重新构建」目标幻灯片——读取原始文件 → 提取某页 → 清空原有形状 → 插入新图片对象。
-
PHPPresentation不支持「覆盖式编辑」，所谓“插入到第 N 页”本质是 clone 页面 + 替换内容 - 图片路径必须是服务器本地绝对路径，
http://或相对路径会静默失败 - 每张图片需手动设置
setOffsetX()和setOffsetY()，否则默认堆在左上角（0, 0） - 插入后记得调用
$objWriter->save($outputPath)，否则所有操作只在内存中
addImageShape() 的坐标和尺寸参数怎么设才不跑偏
图片位置不是用像素，而是以 EMU（English Metric Unit）为单位，1 厘米 ≈ 360000 EMU。直接填像素值会导致图片极小或溢出页面。
更实用的做法是先用 PowerPoint 打开模板 PPTX，按住 Alt 拖动图片，状态栏会显示精确的厘米值，再换算成 EMU（×360000）；或者统一用页面百分比反推：
网趣网上购物系统支持PC电脑版+手机版+APP，数据一站式更新，支持微信支付与支付宝支付接口，是专业的网上商城系统，网趣商城系统支持淘宝数据包导入，实现与淘宝同步更新!支持上传图片水印设置、图片批量上传功能，同时支持订单二次编辑以及多级分类隐藏等实用功能，新版增加商品大图浏览与列表显示功能，使分类浏览更方便，支持最新的支付宝即时到帐接口。
立即学习“PHP免费学习笔记（深入）”；
- 幻灯片默认尺寸为 9144000 × 5148000 EMU（10×5.67 英寸）
- 想让图片居中：
setOffsetX( (9144000 - $width) / 2 ) - 高度建议限制在 3000000 EMU 以内，否则导出后可能被 PowerPoint 截断
- 如果图片拉伸变形，检查是否只设了宽/高之一——必须同时调用
setWidth()和setHeight()保持比例
批量插入时图片顺序错乱或只显示最后一张
典型现象：循环插入 5 张图，结果 PPTX 里只有第 5 张可见，或图层叠在一起看不清。根本原因是没给每张图分配独立的 Slide 对象引用，或重复用了同一个 ImageShape 实例。
- 每次
addImageShape()必须基于新创建的ImageShape，不能复用变量 - 不要在循环外定义
$shape = new ImageShape(...)，然后 inside loop 只改它的属性 - 确保每张图的
setOffsetX/Y()计算逻辑不同（例如用$i * 1000000逐行下移） - 若用
foreach ($images as $i => $path)，注意$i是数组键，不是插入序号；图片数组最好用array_values()重索引
中文路径或文件名导致 FileNotFoundException
错误信息通常是：File not found: /var/www/测试/图1.jpg，即使文件真实存在。这是因为 PHPPresentation 底层用 fopen() 读取，而 PHP 在非 UTF-8 locale 下对中文路径解码失败。
- 最稳方案：把图片全移到英文路径下，如
/tmp/slides_imgs/ - 临时规避：用
iconv('UTF-8', 'GBK', $path)转码（仅 Windows Server 有效） - 绝对不要用
urlencode()，它会产生%E6%B5%8B%E8%AF%95类路径，PHPPresentation不识别 - 调试时加一行
var_dump(file_exists($path), is_readable($path));，确认 PHP 真的能访问该路径
真正麻烦的不是插图动作本身，而是 PPTX 文件结构对图层顺序、EMU 单位、路径编码的隐式约束——这些细节不报错，但会让图片消失、错位或导出失败。动手前先用最小例子验证路径+坐标+保存三步闭环，比后期排查快得多。
