PHP读取PPTX必须用PHPPresentation，因其是唯一稳定支持.pptx结构的开源库；需启用zip/xml扩展，用CACHEDOBJECT方式保存，图片须用绝对路径且仅支持png/jpg/gif。
PHP 读取 PPTX 文件必须用 PHPPresentation，不是 PHPWord 或 PHPExcel
PHP 原生不支持 PPTX 解析，PHPPresentation 是目前唯一能稳定操作 .pptx 结构的开源库（注意：它不支持旧版 .ppt）。很多项目误用 PHPExcel 的遗留思维，结果连文件都打不开，报错 ZipArchive::open(): Invalid or uninitialized Zip object——本质是没意识到 PPTX 是 ZIP 封装的 OPC 包，需要按 XML 节点逐层写入。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 用 Composer 安装：
composer require phpoffice/phppresentation（别选已归档的PHPPresentation0.x 分支） - 确保 PHP 启用了
zip和xml扩展，否则load()会静默失败 - 不要尝试用
file_get_contents()直接读取 .pptx 当二进制处理——它内部有 rels、slides、slideLayouts 多级关系，跳过库直接操作大概率损坏文件结构
插入图片到指定页必须先 cloneSlide()，不能直接 addSlide()
PHPPresentation 的设计逻辑是：新幻灯片必须基于已有 layout 或 slide 实例生成，addSlide() 创建的是空白页，没有母版样式，插入图片后常出现位置偏移、字体丢失、甚至打开提示“内容有问题”。真实场景中，你几乎总是想在某一页（比如第 3 页）后面插入带图的新页，且保持标题栏/页脚/配色一致。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 先用
$presentation->getSlide(2)获取目标页（索引从 0 开始），再$newSlide = $slide->cloneSlide() - 图片插入前，必须调用
$newSlide->createDrawingShape()，而不是直接addImage()（后者不存在） - 设置位置用
setOffsetX()/setOffsetY()，单位是厘米，不是像素；设成0不代表左上角，而是母版定义的默认占位符原点
setImageResource() 只接受绝对路径，相对路径或 URL 会静默失败
常见错误现象：代码没报错，但生成的 PPTX 里图片显示为“无法加载图像”，右键“编辑图片”提示“找不到文件”。这是因为 setImageResource() 底层调用 realpath()，传入 ./images/chart.png 或 https://xxx.com/a.jpg 都会被忽略，最终插入一个空引用。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 统一用
__DIR__ . '/images/photo.jpg'拼接路径，确保存在且可读（加is_readable()判断） - 图片格式仅支持
png、jpg、gif；WebP、AVIF 会触发InvalidArgumentException - 大图（如 >5MB）可能触发内存溢出，建议提前用
imagejpeg()缩放到 1920px 宽度以内
保存后文件打不开？检查 save() 的第二个参数必须是 \PhpOffice\PhpPresentation\IOFactory::CACHEDOBJECT
很多人写 $objWriter->save('out.pptx') 后双击打不开，或提示“文件损坏”。根本原因是 PHPPresentation 默认用内存流写入，而 Office 对 ZIP 内部时间戳、目录顺序敏感，直接输出易产生 CRC 校验失败。这不是 bug，是设计约束。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 必须显式指定缓存方式：
$objWriter->save('out.pptx', \PhpOffice\PhpPresentation\IOFactory::CACHEDOBJECT) - 如果部署在 Docker 或无写权限环境，
CACHEDOBJECT依赖系统临时目录，需确认sys_get_temp_dir()返回路径可写 - 生成后建议用
zip -T out.pptx命令行验证 ZIP 完整性，比人工双击更可靠
最易被忽略的一点：PHPPresentation 不支持在已有图片占位符上“替换”图片，只能新增 shape。如果模板里预设了图片框，你需要先遍历 $slide->getShapeCollection() 找到对应 PictureShape，再用 setImageResource() 覆盖——但这个操作实际是删除旧 shape、新建一个，位置和大小参数得手动对齐。
