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

实现结果与目标

我们的目标是编写一个可复用的 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" );
?>

第2步：关键参数解析

理解命令行中的核心参数有助于灵活调整截图策略：

• -ss 5：表示跳到视频的第5秒位置截图。这是为了避免视频开头常见的黑屏、Logo 水印或过暗场景，选取内容最丰富的片段作为封面更美观。
• -s 286x160：指定输出图片的尺寸。你可以根据实际页面布局需求修改此数值，例如改为 400x225 以适应宽屏显示。
• -vcodec mjpeg：指定输出为 JPEG 格式图片，这是一种通用且体积适中的图片格式。

第3步：执行与验证

将上述代码保存为 PHP 脚本并在浏览器访问或终端运行。如果服务器环境配置正确，脚本将输出一系列日志信息，并在指定目录生成 output.jpg 文件。此时你可以打开该图片，确认其内容是否为视频中指定时刻的画面。

完成判断

当看到终端或页面输出 "Converted" 字样，且指定的输出路径下成功生成了清晰、无损坏的图片文件时，即代表操作成功完成。

简要总结

以上便是基于 PHP 和 FFmpeg 命令行工具快速获取视频预览图的详细内容，更多关于PHP视频处理与前端素材生成的资料请关注本站其它相关文章！