PHP读取图片目录失败主因是路径错误或权限不足；PHPPresentation插图卡死源于内存未释放；PPT损坏多因ZIP结构异常；中文路径需转UTF-8或重命名。
PHP 读取图片目录失败，scandir() 返回空或警告
常见原因是路径没写对，或者 PHP 没权限读取目录。Windows 下路径斜杠方向容易错，Linux 下要注意用户权限和 open_basedir 限制。
- 用
realpath()先校验路径是否存在且可读：realpath('/var/www/images')，别直接拼字符串 - 确保目录末尾不带斜杠，否则
scandir()可能静默失败；传入/path/to/images，不是/path/to/images/ - 过滤掉
.和..必须做，否则后续生成 PPT 时可能把目录当图片塞进去 - 扩展名要严格判断：
in_array(strtolower(pathinfo($file, PATHINFO_EXTENSION)), ['jpg', 'jpeg', 'png', 'gif'])，别只靠文件头
用 PHPPresentation 插入图片卡死或报 MemoryLimit
批量插入几十张图时，PHPPresentation 默认会把每张图完整加载进内存再编码，很容易超限。它不支持流式写入，也没内置图片压缩逻辑。
- 在循环前加
ini_set('memory_limit', '512M')是临时解法，但治标不治本 - 务必用
imagecreatefromxxx()+imagedestroy()主动释放 GD 资源，尤其处理大图前先getimagesize()判断尺寸，超 2000px 宽的建议先缩放 - 不要用
$slide->createMediaShape()直接塞原始文件——改用$slide->createDrawingShape()，并手动指定setPath()和setResizeProportional(true) - 每插入 5 张图后调用
gc_collect_cycles()，能明显缓解内存堆积
生成的 PPT 在 Office 打不开，提示“文件已损坏”
根本原因通常是 ZIP 包结构异常：PHPPresentation 生成的 .pptx 实际是 ZIP，但某些图片 MIME 类型写错、或关系文件（_rels/.rels）里 ID 冲突，Office 就拒绝加载。
- 检查所有图片是否真能被
getimagesize()识别，损坏的 JPG 文件（比如头部缺 FF D8）会导致 ZIP 写入截断 - 避免重复使用同一个
$drawing对象实例插入多张图——每个图必须 new 一个独立PhpPresentation\Shape\Drawing - 输出前强制关闭所有资源：
unset($objPHPPresentation); unset($objWriter);，否则 ZIP 流可能没 flush 完 - 生成后用
zip -T output.pptx（Linux）或 7-Zip 右键“测试压缩包”验证完整性，比双击打开更早发现问题
中文路径/文件名导致图片不显示或乱码
PHPPresentation 内部用 UTF-8 处理文件名，但 Windows 系统默认是 GBK，直接传入中文路径会变成乱码，ZIP 里存的是错的路径，Office 自然找不到图。
立即学习“PHP免费学习笔记（深入）”；
- 统一转为 UTF-8：用
mb_convert_encoding($filename, 'UTF-8', 'auto')，别依赖iconv()（它在部分环境会静默失败） - 不要用中文作图片原始文件名参与路径拼接——重命名为英文哈希值：
$safeName = md5_file($fullPath) . '.jpg'，再 copy 到临时目录 - 如果必须保留中文名，得手动修改 PHPPresentation 源码中
ZipStream的addFile()调用，加上setExtraField()设置 UTF-8 标志位（需 PHP >= 7.4 + zip extension >= 1.15）
