PHP集成FFmpeg实现音视频处理的完整指南
在现代Web开发中，音视频处理需求日益增长，无论是视频转码、格式转换、添加水印还是提取缩略图，FFmpeg都是业界最强大的多媒体处理框架。PHP作为服务端主流语言，通过集成FFmpeg可以轻松实现自动化的音视频处理工作流。本文将详细介绍如何在PHP中集成并使用FFmpeg，提供原生执行与面向对象库两种方案。
一、环境准备与FFmpeg安装
在PHP中使用FFmpeg，首先需要确保服务器已经安装了FFmpeg工具。以Linux（Ubuntu/Debian）为例，可以通过包管理器直接安装：
sudo apt-get update sudo apt-get install ffmpeg
安装完成后，通过命令行验证是否安装成功：
ffmpeg -version
此外，需要确保PHP配置中没有禁用相关的执行函数。在php.ini中检查disable_functions列表，确保exec、shell_exec等函数可用。在生产环境中，开启这些函数存在安全风险，因此需严格校验传入的参数。
二、方案一：通过原生PHP执行命令行
最直接的方式是使用PHP的shell_exec或exec函数来调用FFmpeg命令。这种方式无需引入第三方依赖，适合逻辑简单的场景。
1. 获取视频信息
使用ffprobe获取视频的时长、分辨率等信息：
<?php $videoPath = '/path/to/your/video.mp4'; // 使用ffprobe获取JSON格式的视频信息 $cmd = "ffprobe -v quiet -print_format json -show_format -show_streams " . escapeshellarg($videoPath); $output = shell_exec($cmd); $info = json_decode($output, true); // 提取视频时长（秒） $duration = isset($info['format']['duration']) ? $info['format']['duration'] : 0; echo "视频时长: " . $duration . "秒n"; ?>
注意：必须使用escapeshellarg()对文件路径进行转义，防止恶意用户通过文件名注入危险命令。
2. 视频格式转换与压缩
将视频转换为兼容Web播放的MP4格式（H.264视频编码 + AAC音频编码）：
<?php
$inputPath = '/path/to/input.avi';
$outputPath = '/path/to/output.mp4';
$cmd = "ffmpeg -y -i " . escapeshellarg($inputPath) . " -c:v libx264 -preset medium -crf 23 -c:a aac -strict experimental -movflags +faststart " . escapeshellarg($outputPath);
shell_exec($cmd);
if (file_exists($outputPath)) {
echo "视频转换成功！";
}
?>参数说明：-y覆盖输出文件；-preset medium平衡编码速度与压缩率；-crf 23控制视频质量（0-51，越大质量越差）；-movflags +faststart将元数据移至文件头部，实现Web端边下边播。
3. 截取视频缩略图
<?php $videoPath = '/path/to/video.mp4'; $thumbnailPath = '/path/to/thumbnail.jpg'; // 在视频第5秒截取一张分辨率640x360的图片 $cmd = "ffmpeg -y -i " . escapeshellarg($videoPath) . " -ss 5 -frames:v 1 -s 640x360 " . escapeshellarg($thumbnailPath); shell_exec($cmd); ?>
三、方案二：使用PHP-FFMpeg库（推荐）
直接拼接命令行容易出错且难以维护，推荐使用官方推荐的php-ffmpeg/php-ffmpeg面向对象库。它封装了底层命令，提供了更优雅的API。
1. 安装库
通过Composer安装：
composer require php-ffmpeg/php-ffmpeg
2. 基础使用与视频转码
<?php
require 'vendor/autoload.php';
$ffmpeg = FFMpegFFMpeg::create(array(
'ffmpeg.binaries' => '/usr/bin/ffmpeg',
'ffprobe.binaries' => '/usr/bin/ffprobe',
'timeout' => 3600,
'ffmpeg.threads' => 12,
));
$videoPath = 'http://www.ipipp.com/demo/video.mp4';
$video = $ffmpeg->open($videoPath);
// 转码为X264格式并保存
$format = new FFMpegFormatVideoX264('libmp3lame', 'libx264');
$format->setKiloBitrate(1000)->setAudioKiloBitrate(128);
$video->save($format, '/path/to/export.mp4');
?>3. 提取缩略图与添加水印
<?php
$video = $ffmpeg->open('/path/to/video.mp4');
// 提取第5秒的帧作为缩略图
$frame = $video->frame(FFMpegCoordinateTimeCode::fromSeconds(5));
$frame->save('/path/to/frame.jpg');
// 添加水印
$video->filters()->watermark('/path/to/watermark.png', array(
'position' => 'relative',
'bottom' => 10,
'right' => 10,
));
// 保存添加水印后的视频
$video->save(new FFMpegFormatVideoX264(), '/path/to/watermarked_video.mp4');
?>四、生产环境注意事项
1. 防止PHP请求超时：视频处理是极其耗时的操作，默认的PHP执行时间（通常30秒）肯定会超时。建议将耗时任务放入后台队列（如Redis + Supervisor），通过异步Worker处理，前端轮询处理状态。
2. 资源消耗与并发：FFmpeg转码会吃满CPU，如果并发处理多个视频会导致服务器崩溃。建议在调用FFMpeg::create时限制线程数，或使用服务器信号量（Semaphore）控制同时运行的FFmpeg进程数量。
3. 安全性防范：如果视频路径由用户输入决定，绝对禁止直接拼接路径到命令行中。原生方案务必使用escapeshellarg()，面向对象库底层虽已做部分处理，但仍需校验文件后缀与合法性，防范恶意伪造的媒体文件触发FFmpeg底层漏洞。
4. 进度监听：若需获取转码进度，php-ffmpeg库提供了ProgressListener接口，可通过监听当前时间与总时长来计算百分比，从而在Web端展示进度条，提升用户体验。