最可靠方法是用 FFmpeg 命令行提取关键帧：-ss 00:00:02 跳转、-vframes 1 解码单帧、-q:v 2 控制质量、-y 强制覆盖；PHP 中须用 proc_open() 安全调用，设超时、捕获错误、校验输出，并支持多时间点 fallback 降级。
用 FFmpeg 命令行提取关键帧最可靠
PHP 本身不支持直接解析视频流，所有“自动提取封面”方案都依赖外部工具，ffmpeg 是事实标准。它能精准控制时间点、分辨率、质量，且兼容绝大多数编码格式（H.264/HEVC/VP9 等）。
常见错误是直接调用 exec("ffmpeg -i ...") 却忽略错误输出和超时，导致 PHP 进程卡死或返回空图。务必加参数限制执行时间和静默输出：
-
-ss 00:00:02：跳转到第 2 秒（比-vframes 1前置更高效） -
-vframes 1：只解码 1 帧，避免多余计算 -
-q:v 2：JPEG 质量（1–31，值越小质量越高） -
-y：强制覆盖，防止因文件存在而失败
ffmpeg -ss 00:00:02 -i /path/to/video.mp4 -vframes 1 -q:v 2 -y /path/to/cover.jpg
PHP 中安全调用 ffmpeg 的写法
不能裸用 exec()，需捕获错误、设置超时、校验输出文件。尤其注意：Windows 下路径含空格必须用双引号包裹，Linux 下要确认 www-data 或 nginx 用户有 ffmpeg 执行权限和目标目录写入权限。
- 用
proc_open()替代exec()，可设最大运行时间（如 10 秒） - 检查返回码：
$return_code !== 0说明 ffmpeg 解析失败（常见于损坏视频或不支持编码） - 提取后必须用
file_exists()+getimagesize()双重验证图片有效性 - 避免在 Web 请求中长时间阻塞：大视频建议丢进队列异步处理
不推荐用 getID3 或 PHP-FFMpeg 库的原因
getID3 只能读取嵌入的封面（如 MP4 的 coVR box），绝大多数用户上传的视频根本没有这个字段；PHP-FFMpeg 库本质仍是封装 ffmpeg 命令，但抽象层增加了调试难度——比如它默认不暴露 stderr，出错时只能看到 “Command did not return a valid image”，根本不知道是权限问题还是参数写错。
- 当
ffmpeg报错Invalid data found when processing input，PHP-FFMpeg 往往静默失败 - 它的
frameAt()方法底层仍用-ss+-vframes，没带来额外能力，反而多一层兼容风险 - 升级 ffmpeg 版本后，库的参数适配常滞后（例如新版要求
-c:v mjpeg显式指定编码器）
首帧提取失败时的降级策略
有些视频关键帧稀疏（如 10 秒才一个 I 帧），-ss 00:00:02 可能跳到 B/P 帧导致黑图或报错 Error while opening decoder for input stream。此时应尝试多时间点 fallback：
- 先试
-ss 00:00:01，再试-ss 00:00:05，最后试-ss 00:00:10 - 对每个时间点生成临时文件，用
exif_read_data()检查是否含图像数据（排除纯黑/灰图） - 若全部失败，回退到生成纯色占位图（避免前端 404）并记录日志供人工抽检
真正难处理的是无关键帧的流媒体切片（如 HLS 的 .ts 片段），这种必须先用 ffmpeg -i xxx.ts -c copy -bsf:v h264_mp4toannexb out.h264 提
