在PHP开发中,处理视频转码、剪辑、提取封面等需求时,FFmpeg是非常实用的工具,它可以支持几乎所有主流视频格式的转换和处理。PHP本身没有内置视频处理功能,需要通过调用FFmpeg的命令行工具来实现相关操作,核心是利用PHP的执行系统命令函数来触发FFmpeg指令。

环境准备
要让PHP成功调用FFmpeg,需要先完成两项基础配置。首先是服务器上安装FFmpeg,不同系统的安装方式不同,Linux系统可以通过包管理器安装,Windows系统可以下载官方编译好的二进制文件配置环境变量。其次是PHP需要开启执行系统命令的权限,常用的exec函数、shell_exec函数如果处于禁用状态,需要在php.ini中修改disable_functions配置项,移除对应的函数限制。
常用调用方式
使用exec函数调用
exec函数可以执行外部程序,并且可以获取命令执行后的输出结果,适合需要获取FFmpeg处理状态的场景。下面是使用exec函数调用FFmpeg将MP4视频转码为AVI格式的示例:
<?php
// 源视频路径
$sourceVideo = '/data/videos/source.mp4';
// 目标视频路径
$targetVideo = '/data/videos/target.avi';
// 拼接FFmpeg转码命令
$cmd = "ffmpeg -i {$sourceVideo} -c:v mpeg4 -c:a mp3 {$targetVideo} 2>&1";
// 执行命令,获取输出结果
exec($cmd, $output, $returnCode);
if ($returnCode === 0) {
echo "视频转码成功";
} else {
echo "视频转码失败,错误信息:" . implode(PHP_EOL, $output);
}
?>
使用shell_exec函数调用
shell_exec函数会执行命令并且返回命令输出的全部内容,使用方式更简洁,适合不需要单独获取返回码的场景。下面是使用该函数提取视频首帧作为封面的示例:
<?php
// 源视频路径
$sourceVideo = '/data/videos/source.mp4';
// 封面保存路径
$coverPath = '/data/covers/cover.jpg';
// 拼接提取封面的命令,取视频第1秒的帧作为封面
$cmd = "ffmpeg -i {$sourceVideo} -ss 00:00:01 -vframes 1 {$coverPath}";
// 执行命令并获取输出
$result = shell_exec($cmd);
if (file_exists($coverPath)) {
echo "封面提取成功";
} else {
echo "封面提取失败";
}
?>
常见处理场景示例
视频剪辑
如果需要截取视频的某一段内容,可以通过FFmpeg的时间参数实现,下面是截取视频从第10秒开始,时长5秒的片段的示例:
<?php
$sourceVideo = '/data/videos/source.mp4';
$clipVideo = '/data/videos/clip.mp4';
// -ss 指定开始时间,-t 指定截取时长
$cmd = "ffmpeg -i {$sourceVideo} -ss 00:00:10 -t 5 -c copy {$clipVideo}";
exec($cmd, $output, $returnCode);
if ($returnCode === 0) {
echo "视频剪辑成功";
}
?>
获取视频基本信息
可以通过FFmpeg的-i参数配合输出重定向,获取视频的时长、分辨率、编码格式等信息,示例代码如下:
<?php
$sourceVideo = '/data/videos/source.mp4';
// 获取视频信息,2>&1 将错误输出重定向到标准输出
$cmd = "ffmpeg -i {$sourceVideo} 2>&1";
$output = shell_exec($cmd);
// 简单匹配视频时长
preg_match('/Duration: (.*?),/', $output, $matches);
if (!empty($matches[1])) {
echo "视频时长:" . $matches[1];
}
?>
注意事项
- 调用FFmpeg处理大视频时,执行时间可能超过PHP默认的30秒超时限制,需要通过
set_time_limit(0)设置脚本无超时限制,避免处理中断。 - 传递给FFmpeg的文件路径需要做好校验,避免路径注入风险,不要直接使用用户输入的内容拼接命令。
- 如果服务器是Windows系统,命令中的路径分隔符需要使用反斜杠,或者统一使用正斜杠,避免路径识别错误。
- FFmpeg命令执行失败时可以查看错误输出,大部分错误都是路径错误、权限不足或者FFmpeg未正确安装导致的。