PHP 8 中通过 exec() 等函数调用系统 FFmpeg 提取视频封面，需服务器已安装 FFmpeg 并配置 PATH；常用命令为 ffmpeg -i 视频路径 -ss 00:00:01 -vframes 1 -q:v 2 封面路径；须 escapeshellarg() 防注入，并检查返回结果。
PHP 8 中调用 FFmpeg 提取视频封面（即首帧或指定时间点的缩略图），本质是通过 exec()、shell_exec() 等函数执行系统命令，而非 PHP 原生支持。关键前提是：服务器必须已安装并可访问 FFmpeg 命令行工具。
确认 FFmpeg 已正确安装并可用
在 PHP 中先验证 FFmpeg 是否就绪，避免后续命令静默失败：
- 用
exec('which ffmpeg', $output, $returnCode)或exec('ffmpeg -version', $output, $returnCode)检查路径与版本 - 若返回空或
$returnCode !== 0，说明未安装或不在PATH中，需联系运维或自行配置（如指定绝对路径/usr/local/bin/ffmpeg） - PHP 进程需有读取视频文件、写入目标目录的权限
基础命令：提取第一帧为 JPG 封面
最常用方式是截取视频第 0 秒（或第 1 秒）的关键帧：
- 命令示例：
ffmpeg -i /path/to/video.mp4 -ss 00:00:01 -vframes 1 -q:v 2 /path/to/cover.jpg -
-ss 00:00:01表示跳转到第 1 秒（比-ss 0更稳定，避免非关键帧解码失败） -
-vframes 1只输出 1 帧；-q:v 2控制 JPEG 质量（值越小质量越高，2~5 较常用） - PHP 中安全调用（注意过滤路径、防止命令注入）：
$videoPath = escapeshellarg('/var/www/videos/demo.mp4');
$coverPath = escapeshellarg('/var/www/covers/demo.jpg');
$cmd = "ffmpeg -i {$videoPath} -ss 00:00:01 -vframes 1 -q:v 2 {$coverPath} 2>&1";
$output = shell_exec($cmd);
if (file_exists($coverPath)) {
echo "封面生成成功：".basename($coverPath);
} else {
error_log("FFmpeg 失败：".$output);
}
进阶技巧：按分辨率缩放 + 防黑边 + 指定格式
生产环境常需统一尺寸、去除黑边、适配不同终端：
立即学习“PHP免费学习笔记（深入）”；
- 加缩放与裁剪：
-vf "scale=320:180:force_original_aspect_ratio=decrease,crop=320:180"（等比缩放后居中裁切） - 强制输出 PNG（透明背景需求）：
-f image2 -vcodec png，结尾改用.png - 跳过音频处理加快速度：
-an（虽截帧无需音频，但显式声明更清晰） - 超时防护（PHP 层）：
set_time_limit(30)防止大视频卡死
替代方案：用 FFmpeg-PHP 扩展？
PHP 8 已不支持旧版 ffmpeg-php 扩展（仅兼容 PHP 5.x），目前无主流、维护中的原生 FFmpeg 扩展。推荐坚持命令行调用，或封装为独立服务（如用 Python+FFmpeg 提供 HTTP 接口，PHP 调用 API），更可控、易调试、不阻塞 Web 进程。
