PHP 使用 FFmpeg 获取视频封面图实战

落日邮差

发布时间：2026-10-14| 5人浏览过

原创

本教程介绍了一种在 PHP 环境中高效获取视频预览图（封面）的实用方案。核心原理是利用系统已有的 ffmpeg 工具，通过 PHP 的 shell_exec 函数执行特定命令行指令，从视频流中提取单帧图像并保存为图片文件。

实现结果与目标

我们的目标是编写一个可复用的 PHP 函数，输入任意合法的视频文件路径和输出图片路径，即可自动生成对应视频的缩略图。该方法不依赖复杂的第三方扩展，仅需服务器支持命令行操作及安装好 ffmpeg。

准备条件

在开始编码前，请确保您的开发环境满足以下基础要求：

服务器环境：Linux 或 Windows 均可，需具备执行外部命令的权限。
核心依赖：服务器必须已安装 ffmpeg 软件，且 ffmpeg 命令已加入系统环境变量 PATH，以便在任何目录下直接调用。
PHP 配置：shell_exec 函数未被禁用（检查 php.ini 中的 disable_functions 配置项）。

真实操作顺序

第1步：构建处理函数

我们创建一个名为 convertToFlv 的函数（注：虽然函数名提及 Flv，但代码实际是将视频第一帧转为图片），该函数接收输入视频路径和输出图片路径两个参数。

动作逻辑：
首先打印当前处理的文件名以方便调试；接着拼接完整的 ffmpeg 命令行字符串；最后通过 PHP 内置函数执行该命令。

<?php
function convertToImage( $input, $output ) {
    echo "Converting $input to $output<br />";
    // 构建 ffmpeg 命令
    // -v 0: 降低日志级别
    // -y: 覆盖输出文件
    // -i: 输入源
    // -ss 5: 从第5秒处开始截取（避免黑屏或过暗画面）
    // -vframes 1: 只取1帧
    // -vcodec mjpeg: 视频编码格式设为 mjpeg (JPG)
    // -f rawvideo: 原始视频格式输出（此处配合后续参数使用）
    // -s 286x160: 强制缩放分辨率
    // -aspect 16:9: 保持宽高比
    $command = "ffmpeg -v 0 -y -i $input -vframes 1 -ss 5 -vcodec mjpeg -f rawvideo -s 286x160 -aspect 16:9 $output ";
    
    echo "$command<br />";
    // 执行系统命令
    shell_exec( $command );
    echo "Converted<br />";
}

// 示例调用
convertToImage( "some-video-input.avi", "output.jpg" );
?>