你想把一组按序号命名的图片合成一段视频,比如把截图做成演示动画、把帧序列导出成短片,却在 PHP 里不知道从哪下手。先给结论:PHP 把图片序列合成视频主要有三条路——调用 FFmpeg 命令行、用 GD 库逐帧处理后再交给编码器、或者借助现成的图像视频扩展,其中调用 FFmpeg 是最通用、最稳的做法。三种方式在依赖、性能和可控性上差别很大,选错会让你在环境配置上耗掉大量时间。本文用可复现的命令和代码,把三种写法讲清楚,并附上常见失败的处理方式,帮你在自己的场景里选对方案。

先看结论
- 调用 FFmpeg 是把图片序列合成视频的首选:稳定、格式支持全、参数可控,PHP 只负责拼命令并调用。
- GD 库适合先对每张图做裁剪、加水印等处理,但它本身不直接编码视频,最终仍需编码器配合。
- 现成扩展封装度高但依赖特定环境,通用性不如 FFmpeg。
- 图片必须按序号连续命名,缺号会导致合成时跳帧或直接中断,这是最容易被忽略的前置。
一、先准备规范的图片序列
无论用哪种方式,第一步都是准备一组规范的图片。把图片放在同一目录,按连续序号命名,例如 frame_0001.png、frame_0002.png……中间不能缺号。很多合成失败的根因,就是文件名不连续或位数不统一导致排序错乱。
先看目录里的文件是否规范:
# 列出图片并按名称排序,确认序号连续
ls -1 frames/ | sort
这条命令按名称排序列出图片,肉眼看一遍序号是否连续。位数要统一(都用 4 位),否则 frame_9.png 会排在 frame_10.png 后面,顺序就乱了。PHP 里处理图像的基础函数,可以配合 PHP 速查手册 快速查阅,拼文件名时常用到的字符串函数都在里面。
⚠️ 注意:合成视频属于 CPU 密集型任务,图片多、分辨率高时会占用大量内存和磁盘。务必确认磁盘有足够剩余空间,生产环境建议放在任务队列里异步执行,别塞进 Web 请求里同步跑。
二、写法一:调用 FFmpeg(最推荐)
FFmpeg 是处理音视频的瑞士军刀,把图片序列合成视频是它的基本能力。PHP 要做的是拼好命令,再用 exec 或 Symfony Process 调用它。
先直接用命令行验证命令是否正确:
# 把 frames 目录下 frame_%04d.png 合成 25fps 的 mp4
ffmpeg -framerate 25 -i frames/frame_%04d.png -c:v libx264 -pix_fmt yuv420p output.mp4
这里 %04d 是占位符,匹配四位数字的序号;-framerate 25 设定每秒 25 帧;-pix_fmt yuv420p 保证生成的 mp4 在多数播放器里能正常播放。命令跑通后,再用 PHP 调用:
<?php
// 拼装 FFmpeg 命令并用 exec 执行
$cmd = sprintf(
'ffmpeg -y -framerate 25 -i %s -c:v libx264 -pix_fmt yuv420p %s 2>&1',
escapeshellarg('frames/frame_%04d.png'),
escapeshellarg('output.mp4')
);
$output = [];
$code = 0;
exec($cmd, $output, $code);
if ($code !== 0) {
// 失败时打印 FFmpeg 的错误输出,便于定位
throw new RuntimeException('合成失败:' . implode("\n", $output));
}
echo "合成完成:output.mp4\n";
关键点有两个:一是用 escapeshellarg 包裹路径,避免文件名里的空格或特殊字符导致命令出错;二是检查退出码 $code,非 0 时把 $output 里的错误信息打出来。参数记不全时,回看 Php5To7 教程 里关于 exec 与进程调用的示例能少走弯路。
三、写法二:GD 库预处理 + 编码
第二种方式适合需要先处理每张图的场景,比如统一尺寸、加水印、加文字。PHP 的 GD 库能逐张读取和加工图片,但它不直接编码视频,处理后的帧仍要交给 FFmpeg 之类的工具合成。
<?php
// 用 GD 统一把每张图缩放到 1280x720,输出到 processed 目录
$src = 'frames';
$dst = 'processed';
if (!is_dir($dst)) {
mkdir($dst, 0755, true);
}
foreach (glob("$src/frame_*.png") as $file) {
$img = imagecreatefrompng($file);
if ($img === false) {
throw new RuntimeException("无法读取:$file");
}
$resized = imagecreatetruecolor(1280, 720);
imagecopyresampled($resized, $img, 0, 0, 0, 0, 1280, 720,
imagesx($img), imagesy($img));
imagepng($resized, $dst . '/' . basename($file));
imagedestroy($img);
imagedestroy($resized);
}
echo "预处理完成\n";
这段把 frames 里每张图缩放到 1280×720 后存到 processed 目录,之后把 FFmpeg 命令的输入路径改成 processed 即可。从性能取舍看,多一次缩放和另存会增加耗时与磁盘占用,只有在确实需要统一尺寸时才值得。若只是单纯合成,直接用写法一更省事。三种方式对比如下:
| 方式 | 依赖 | 可控性 | 适用场景 |
|---|---|---|---|
| FFmpeg 命令行 | 需装 FFmpeg | 高,参数丰富 | 通用首选 |
| GD 预处理 + 编码 | GD + FFmpeg | 高,可逐帧处理 | 需裁剪/水印 |
| 现成扩展 | 特定 PHP 扩展 | 中,封装度高 | 环境已具备 |
四、写法三与方案取舍
第三种方式是借助现成的图像视频扩展或 SDK。这类工具把合成过程封装成几个方法调用,代码量最少,但代价是依赖特定的 PHP 扩展或商业服务,环境迁移时容易出问题。只有在你的运行环境已经具备对应扩展、且不打算换环境时,才建议考虑这条路。对绝大多数从零开始的项目,写法一的 FFmpeg 依然是最稳妥的起点——它的参数透明、报错信息清晰,出了问题也容易搜索到解法。
选方案时可以用一个简单判断:先问"需不需要逐帧处理图片"。不需要,直接用 FFmpeg 一条命令搞定;需要裁剪、加水印、加文字,就在 FFmpeg 前面加一层 GD 预处理;只有当环境已经装好现成扩展、且你明确不想引入 FFmpeg 时,才选第三种。这个判断能帮你避开"为了用某种技术而硬套"的坑。从可维护性看,FFmpeg 命令可以单独抽成一个函数或服务类,路径、帧率、编码参数都做成配置项,日后调整帧率或输出格式时只改配置,不用翻遍业务代码。

动手核对清单
前置与环境
确认已安装 FFmpeg(ffmpeg -version 能打印版本);确认 PHP 启用了 GD(php -m 里有 gd);确认磁盘空间充足。
操作
准备连续命名的图片序列;先跑命令行验证合成命令;再用 PHP 调用并检查结果。
检查与验证
输出 output.mp4 后,用播放器打开确认时长和画面顺序正确;检查文件大小是否非零。
失败处理
报"找不到文件"先核对 %04d 与实际命名;报编码器错误先确认 libx264 可用;画面跳帧先检查序号是否缺号。

总结
PHP 把图片序列合成视频,最通用的是调用 FFmpeg,PHP 负责拼命令和处理结果;需要逐帧加工时再加一层 GD 预处理;现成扩展封装度高但依赖特定环境。无论哪种方式,规范连续的图片命名都是前提,缺号或位数不统一会直接导致失败。选方案时按"是否需要逐帧处理"来决定:不需要就直接用 FFmpeg,需要才叠加 GD,避免为了用而用。
常见问题
Q:FFmpeg 报找不到图片,可文件明明在目录里?
A:多数是命名不匹配。frame_%04d.png 要求四位数字且连续,检查实际文件名是否为 frame_0001.png 这样的格式,中间是否缺号。位数不统一也会导致匹配失败。
Q:合成的 mp4 在某些播放器里放不出来?
A:通常是像素格式问题。加上 -pix_fmt yuv420p 参数重新合成,这个格式兼容性最好,能被绝大多数播放器和浏览器识别。
Q:图片很多时合成特别慢甚至内存溢出怎么办?
A:合成是 CPU 和内存密集型任务。降低单张分辨率、减少帧数,或把任务放到队列里异步执行。不要在 Web 请求里同步跑长视频合成,容易超时。

TRAE-AI编程



