在php开发场景下，如果需要自动化处理PPT幻灯片内容，批量插入图片是高频需求，比如生成带多张产品图的汇报PPT、批量制作带照片的证书PPT等，手动操作效率极低，通过代码实现可以大幅提升处理效率。
环境准备
首先需要安装PHPOffice_PHPWord库，这个库支持操作PPT、Word、Excel等办公文档，我们可以通过composer完成安装，执行以下命令即可：
composer require phpoffice/phpword
安装完成后，需要确认php环境开启了zip扩展，因为PPT文件本质是zip压缩包格式，该扩展是读写PPT文件的必要依赖。
核心实现步骤
1. 加载PPT模板或创建新PPT
如果是基于现有PPT模板插入图片，需要先加载模板文件，如果是全新生成PPT，就创建空白PPT实例，两种方式的核心代码如下：
<?php
require 'vendor/autoload.php';
use PhpOfficePhpWordPhpWord;
use PhpOfficePhpWordIOFactory;
// 加载现有PPT模板
$phpWord = IOFactory::load('template.pptx', 'PowerPoint2007');
// 如果是创建新PPT，使用下面这行代码
// $phpWord = new PhpWord();
2. 准备待插入的图片列表
我们需要先把所有要插入的图片路径整理成数组，方便后续循环处理，示例代码如下：
// 待插入的图片路径数组，实际开发中可以从数据库或文件目录读取
$imageList = [
'images/pic1.jpg',
'images/pic2.jpg',
'images/pic3.jpg',
'images/pic4.jpg'
];
3. 遍历图片批量插入到幻灯片
接下来遍历图片数组，为每个图片创建新的幻灯片，或者插入到指定幻灯片中，这里以每个图片插入到独立幻灯片为例，代码如下：
// 获取PPT中所有幻灯片
$slides = $phpWord->getAllSections();
// 如果PPT是空的，先创建一个幻灯片
if (empty($slides)) {
$slide = $phpWord->addSection();
$slides[] = $slide;
}
$slideIndex = 0;
foreach ($imageList as $imagePath) {
// 如果当前幻灯片索引超过已有幻灯片数量，创建新幻灯片
if ($slideIndex >= count($slides)) {
$slide = $phpWord->addSection();
$slides[] = $slide;
} else {
$slide = $slides[$slideIndex];
}
// 插入图片，设置图片宽度高度和位置
$slide->addImage($imagePath, [
'width' => 400,
'height' => 300,
'positioning' => 'absolute',
'x' => 100,
'y' => 100
]);
$slideIndex++;
}
4. 保存修改后的PPT文件
完成图片插入后，将修改后的PPT保存到指定路径，代码如下：
// 保存文件到output目录
$writer = IOFactory::createWriter($phpWord, 'PowerPoint2007');
$writer->save('output/result.pptx');
echo 'PPT批量插入图片完成';
参数配置说明
在addImage方法中，我们可以配置多个参数来调整图片的显示效果，常用的参数说明如下：
| 参数名 | 说明 | 默认值 |
|---|---|---|
| width | 图片宽度，单位为像素 | 原图宽度 |
| height | 图片高度，单位为像素 | 原图高度 |
| positioning | 定位方式，可选absolute（绝对定位）、relative（相对定位） | relative |
| x | 绝对定位时的横坐标，单位为像素 | 0 |
| y | 绝对定位时的纵坐标，单位为像素 | 0 |
注意事项
- 插入的图片路径必须是服务器可访问的绝对路径或相对路径，避免路径错误导致图片插入失败
- 如果PPT模板中有固定的占位符，也可以先定位占位符位置再插入图片，不需要每个图片都创建新幻灯片
- 批量插入大量图片时，建议增加内存限制，避免php内存溢出，可以在代码开头添加
ini_set('memory_limit', '512M');
php批量插入图片PHPOffice_PHPWordPPT幻灯片幻灯片操作修改时间：2026-06-19 06:33:19