根本原因是PHP原生不支持解析PPTX，必须用PHPPresentation库（推荐v1.3.0）基于OPC标准解压并解析XML；图片旋转/翻转需修改节点的rot、flipH等属性，而非操作图片文件本身。
PHP 读取 PPTX 图片失败：根本原因是没用 PHPPresentation
PHP 原生不支持解析 PPTX 文件，fopen() 或 SimpleXML 直接读 .pptx 只会得到 ZIP 结构乱码。真正能操作图片元数据（包括旋转角度、翻转标志）的只有少数库，目前稳定可用的是 PHPPresentation（phpoffice/phppresentation），它基于 OPC 标准解压并解析 XML 内容。
常见错误现象：Warning: DOMDocument::load(): Start tag expected —— 这是把整个 .pptx 当 XML 直接加载导致的；或者用 ZipArchive 手动解压后找不到 slide1.xml 里的 <sp></sp> 形状节点，因为路径和命名空间没处理对。
-
PHPPresentation支持 PHP 7.4+，但 2.0 版本起不再维护，必须用 dev-main 或 1.x 最后稳定版（如v1.3.0） - 不要尝试用
imagick或gd对 PPTX 里嵌入的图片做旋转——那些图片是 Base64 编码或二进制 blob，且旋转/翻转逻辑存在 XML 属性中，不是像素级变换 - 图片实际渲染效果由
<sppr></sppr>下的<xfrm></xfrm>节点控制：rot（度数）、flipH、flipV，修改这些才生效
批量修改每张幻灯片中所有图片的旋转角度
不是“遍历图片文件”，而是遍历每张幻灯片中的 Shape，筛选出 PictureShape 类型，再改它的变换属性。注意：PPTX 中图片可能被封装在组（GroupShape）里，PHPPresentation v1.x 默认不递归解析组内形状，需手动展开。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 用
$slide->getShapes()获取顶层形状，对每个$shape判断instanceof \PhpOffice\PhpPresentation\Shape\Picture - 调用
$shape->getTransformation()->setRotation(90)即可设旋转角度（单位是“千分之一度”，所以 90° 要传90000） - 若图片在组内，先检查
$shape instanceof \PhpOffice\PhpPresentation\Shape\Group，再用$group->getShapes()二次遍历 - 别漏掉母版页（
$presentation->getMasterSlide(0)），否则模板自带的图片不会变
// 示例：把所有图片顺时针转 180°
foreach ($presentation->getAllSlides() as $slide) {
foreach ($slide->getShapes() as $shape) {
if ($shape instanceof \PhpOffice\PhpPresentation\Shape\Picture) {
$shape->getTransformation()->setRotation(180000);
}
}
}
水平/垂直翻转图片：只改 XML 属性，不重绘图像
PPTX 的翻转不是生成新图，而是设置 <xfrm fliph="1"></xfrm> 这类标记。用户保存后再打开，PowerPoint 自动按此渲染。但 PHPPresentation 的 API 没有直接暴露 flipH 方法，得绕一下。
关键点：
- 调用
$shape->getPresentation()->getActiveSlide()->getShapeById($shape->getId())并不可靠，ID 在序列化时可能变化 - 正确做法是获取底层 XML 元素：
$shape->getXmlObject()返回DOMElement，然后用setAttribute('flipH', '1') - 必须同时调用
$shape->refreshElement()（v1.x 中存在该方法），否则修改不写回 XML 树 - 翻转和旋转可以共存：
rot="90000" flipH="1"是合法组合，无需担心冲突
保存后 PowerPoint 打不开？检查 ZIP 包结构完整性
用 PHPPresentation 修改后调用 $objWriter->save('out.pptx')，看似成功，但双击打不开或提示“文件已损坏”——大概率是 ZIP 写入时漏了某些必要部件（比如 [Content_Types].xml 或 _rels/.rels）。
容易踩的坑：
- 别用
file_put_contents()直接写二进制流，必须走\PhpOffice\PhpPresentation\Writer\Pptx实例的save() - 确保所有
Slide都已添加到Presentation对象，空幻灯片也得显式$presentation->addSlide() - 如果中途报
Call to a member function getElementsByTagNameNS() on null，说明某个DOMDocument加载失败，通常是 XML 命名空间声明缺失，此时应降级到v1.2.0版本（对命名空间容忍度更高） - 调试时用
unzip -t out.pptx检查 ZIP 完整性，再用unzip -l out.pptx | grep xml确认关键 XML 文件是否存在
复杂点在于：旋转/翻转逻辑分散在多个 XML 文件（slide1.xml、slide2.xml、notesSlide1.xml），而 PHPPresentation 不默认处理备注页里的图片。如果需求真要全覆盖，得手动遍历 $presentation->getNotesSlides() 并重复相同逻辑。
