phppresentation 是目前最稳定、能写入图片且兼容较新 pptx 格式的方案；需用 composer 安装，图片须为本地绝对路径、支持 jpg/png/gif，坐标单位为 emus，批量处理应复用实例并手动触发垃圾回收。
用 PHPPresentation 给每页幻灯片插入图片
直接结论：PHP 原生不支持 PPT 操作，必须依赖第三方库；PHPPresentation 是目前最稳定、能写入图片且兼容较新 PPTX 格式的方案。别试 PHPWord 或自己拼 XML，会卡在关系引用和压缩包结构上。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 用 Composer 安装：
composer require phpoffice/phppresentation（注意不是phpoffice/phpspreadsheet） - 它不读取现有 PPT 的图片占位符，所以“批量嵌入到每个幻灯片”得手动循环创建新幻灯片或清空旧内容再重插
- 图片路径必须是本地绝对路径（
/var/www/images/photo1.jpg），相对路径或 URL 会静默失败 - 插入前务必检查图片格式——只支持
.jpg、.png、.gif；.webp会报Invalid image type
addImage 的坐标和尺寸为什么总偏移？
因为 PHPPresentation 的坐标系原点在幻灯片左上角，单位是“EMUs”（English Metric Units），不是像素。1 像素 ≈ 9525 EMUs，硬换算容易错。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 别手算
x/y，用预设常量更稳：\PhpOffice\PhpPresentation\Shape\Image::ANCHOR_CENTER可居中，但仅限单图；多图需手动布局 - 宽高建议用
resizeToWidth或resizeToHeight，比如：$shape->resizeToWidth(800000)（≈84px） - 如果图片被裁切，大概率是
resizeToWidth同时没关等比缩放——加->setResizeProportional(true) - EMUs 数值超大（如
1000000）反而可能溢出边界，建议控制在600000–1200000区间内测试
批量处理时内存爆掉或生成文件打不开
常见错误现象：Fatal error: Allowed memory size of ... exhausted，或生成的 PPTX 在 PowerPoint 里提示“已修复问题”。根本原因是每张图片都被完整加载进内存，并重复打包进 ZIP 结构。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 用
gc_collect_cycles()在每轮循环末尾手动触发垃圾回收 - 避免在循环里反复
new \PhpOffice\PhpPresentation\PhpPresentation()，应该复用一个实例，用$presentation->removeSlide($index)清空旧页 - 图片太大（>2MB）时先用
imagejpeg或imagewebp压缩再写入临时文件，别直接塞原始高清图 - 生成后用
zip -T your.pptx命令校验 ZIP 完整性，损坏的 PPTX 往往是 MIME 类型写错或[Content_Types].xml缺失图片条目
Windows 下中文路径图片无法加载
不是编码问题，是 PHPPresentation 底层用 fopen 读图，而 Windows 的 PHP 默认不支持 UTF-8 路径（即使文件名是中文）。错误信息通常是：Warning: fopen(...): failed to open stream: No such file or directory，但文件明明存在。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 把图片统一移到无中文路径下，例如
C:\ppt_assets\，然后用realpath()转成绝对路径再传给addImage - 不要用
mb_convert_encoding转路径，没用；iconv('UTF-8', 'GBK', $path)也无效，底层不走这个逻辑 - 开发时优先在 Linux/macOS 测试，Windows 环境下务必验证路径是否被
file_exists()认可
