php批量导入图片失败主因是路径错误和权限问题，应使用__dir__动态拼接路径、统一文件后缀、转码中文名；phppresentation需手动缩放图片并显式设置宽高，正确嵌入媒体资源，分批处理防内存溢出，且须真机验证渲染效果。
PHP 读取图片文件失败或路径错误
批量导入前最常卡在读不到图，不是权限问题就是路径没转义。PHP 的 glob() 或 scandir() 对相对路径很敏感，尤其在 CLI 和 Web 环境下工作目录不同。$_SERVER['DOCUMENT_ROOT'] 在 CLI 下根本不存在，硬写会报 Undefined index。
- 用
__DIR__或dirname(__FILE__)替代动态路径拼接，比如：glob(__DIR__ . '/images/*.jpg') - 确保图片后缀统一：
glob()不自动忽略大小写，*.JPG和*.jpg是两回事；建议先用array_filter($files, 'is_file')过滤掉目录项 - 遇到中文文件名？别直接传给
file_get_contents()—— PHP 5.6+ 需先mb_convert_encoding($path, 'UTF-8', 'auto')，否则返回 false
用 PHPPresentation 插入图片时尺寸错乱
PHPPresentation 默认按原始像素插入，不缩放也不适配幻灯片画布，结果要么溢出、要么小得看不见。它没有「自适应」开关，必须手动计算宽高比并约束最大尺寸。
- 幻灯片默认尺寸是 914400×514800 英寸单位（EMUs），换算成像素约 10"×5.67" @96dpi → 实际安全区域建议按
960×540px 控制 - 用
getimagesize()获取原图宽高，再按比例缩放到不超过幻灯片宽度（如 960）且高度 ≤ 540，保持宽高比：$scale = min(960 / $orig_w, 540 / $orig_h); - 插入时必须显式传入缩放后的尺寸：
$shape->setHeight($orig_h * $scale)和$shape->setWidth($orig_w * $scale)，漏掉任一参数就会回退到原始尺寸
批量生成 PPTX 后打开提示“内容有问题”
这不是代码报错，而是 PHPPresentation 生成的 ZIP 结构或 XML 命名空间有细微偏差，Office 比较敏感。常见于图片嵌入方式不对或 MIME 类型未声明。
- 务必用
$slide->createDrawingShape()而非addImage()（后者只支持背景图，不进内容流） - 插入前调用
$presentation->addMedia($imageData, 'image/jpeg')并保存返回的$mediaId，再把$mediaId传给setMediaId()—— 漏这步会导致图片丢失，只留占位框 - 导出后别直接双击打开：先用
zip -T output.pptx检查 ZIP 完整性，再用文本编辑器打开[Content_Types].xml，确认有类似<override partname="/ppt/media/image1.jpg" contenttype="image/jpeg"></override>的条目
内存爆掉或超时（尤其 >50 张图）
PHPPresentation 把整个 PPTX 结构存在内存里，每张图都解码为 GD 资源再编码进 ZIP，不做释放会滚雪球。CLI 下默认内存限制 128M，2MB/图撑不过 60 张。
立即学习“PHP免费学习笔记（深入）”；
- 每插完一张图，立刻
unset($shape); imagedestroy($imgResource);（如果用了 GD 处理缩略图） - 关闭自动压缩：
$objWriter = IOFactory::createWriter($presentation, 'PowerPoint2007'); $objWriter->setIncludeCharts(false);，图表相关 XML 会省下不少体积 - 改用分批写入：每 20 张图生成一个子 PPTX，最后用 ZIP 工具合并（需手动修补
[Content_Types].xml和/ppt/slides/slide*.xml中的索引），比硬扛更稳
真正麻烦的是图片 DPI 和 PPT 渲染逻辑不一致 —— 即便你算对了 EMUs，Windows 上 PowerPoint 可能按 96dpi 解析，macOS 可能按 72dpi，同一份文件预览效果不同。测试阶段必须在目标系统上真机打开验证，不能只看生成日志。
