Composer不处理视频帧或关键帧——它只是PHP依赖管理器，仅负责安装php-ffmpeg等库；真正执行关键帧定位、时间范围裁剪和导出的是ffprobe与ffmpeg命令组合。
Composer 不处理视频帧，也不清理关键帧——这是常见误解的源头。
你真正想用的工具是 ffprobe + ffmpeg，而 Composer 只是 PHP 的包管理器，它只负责安装像 php-ffmpeg/php-ffmpeg 这样的库，不参与任何帧级操作。
为什么 Composer 不能按时间范围清理关键帧
Composer 的职责非常明确：下载、解析 composer.json、拉取依赖包、写入 vendor/ 目录。它没有视频解码能力，不读取 .mp4 文件结构，更不会识别 I 帧或 GOP 边界。
所谓“清理关键帧”，本质是重编码时跳过某些帧、或剪辑时对齐 I 帧边界，这些必须由 ffmpeg 在命令行或通过 PHP-FFMpeg 封装调用完成。
实际能做“时间范围+关键帧控制”的命令组合
要实现「在指定时间段内只保留关键帧」或「从某时间点起剪出一段且开头就是 I 帧」，得靠以下组合：
-
ffprobe先扫出所有关键帧时间戳：ffprobe -select_streams v -show_frames -show_entries frame=pkt_pts_time,pict_type -of csv input.mp4 | grep -w "I"
- 用脚本（如 Bash 或 PHP）筛选出
pkt_pts_time落在目标区间（例如00:01:30到00:02:00）内的 I 帧时间点 - 把第一个匹配的 I 帧时间作为
-ss输入值，再配合-to截取：ffmpeg -ss 00:01:32.400 -i input.mp4 -to 00:02:00 -c:v libx264 -keyint_min 1 -g 1 -c:a aac output.mp4
（注意：这里强制每帧都是 I 帧，仅用于演示；生产环境慎用-g 1） - 若只需提取这些关键帧为图片，用：
ffmpeg -i input.mp4 -vf "select='eq(pict_type\,I)'" -vsync vfr frame_%04d.png
，再配合-ss/-to限定时间范围
PHP-FFMpeg 库里怎么安全调用关键帧逻辑
如果你已用 composer require php-ffmpeg/php-ffmpeg 装好库，真正起作用的是它封装的 ffmpeg 命令调用，不是 Composer 本身。几个实操要点：
- 不要直接传
fromSeconds(90)截图——90 秒未必是 I 帧，可能糊或黑屏；先用ffprobe查最近的前一个 I 帧时间，再传进去 -
$video->filters()->custom('select', "eq(pict_type\,I)")可以加帧过滤，但必须搭配-vsync vfr参数，否则输出会补帧失真 - PHP 超时设置很重要：
'timeout' => 300，因为扫描关键帧+重编码可能耗时较长，尤其 4K 视频 - 路径权限和磁盘空间比参数还容易出错：确保
/tmp/或截图目录可写，且有至少 2 倍视频大小的空闲空间
关键帧不是“清理”出来的，而是靠定位、对齐、再裁或再编码“导出来”的。所有时间精度问题，最终都落在 ffprobe 扫帧 + ffmpeg 对齐这个闭环上，Composer 只是帮你把调用胶水粘得更牢一点。
