PHP调用FFmpeg需满足三前提：服务器已安装并配置PATH、PHP未禁用exec等函数、Web用户对文件有读写权；常用操作包括生成封面图、获取时长分辨率、转码为Web兼容格式。
PHP 调用 FFmpeg 命令行的前提条件
PHP 本身不内置视频处理能力，所谓“调用 FFmpeg 辅助播放”，本质是通过 exec、shell_exec 等函数触发系统级 FFmpeg 命令，生成缩略图、转码、提取元信息等，再由前端（如 HTML5 ）直接加载处理后的文件。不是 PHP 在“播放”视频，而是它在为播放做准备。
必须确认以下三点已就绪：
- 服务器已安装 FFmpeg，且在
$PATH中可执行（运行which ffmpeg应返回路径） - PHP 进程有权限执行外部命令（
disable_functions中未禁用exec、shell_exec、passthru等） - Web 服务器用户（如
www-data或nginx）对输入视频、输出目录有读写权限
生成封面图：用 ffmpeg -i + -ss + -vframes 1
常见需求是截取第 5 秒的帧作为封面。直接拼接命令易出错，关键点在于参数顺序和时间精度：
-
-ss放在-i前是“快进前 seek”，速度快但精度略低；放在-i后是“解码后 seek”，精度高但慢——对封面图，推荐前置-ss - 输出路径必须可写，且扩展名需明确（如
.jpg），否则 FFmpeg 可能报Unable to find a suitable output format - 务必用
escapeshellarg()包裹用户输入的文件路径，防止命令注入
ffmpeg -ss 5 -i /path/to/input.mp4 -vframes 1 -q:v 2 /path/to/thumb.jpg
PHP 调用示例：
立即学习“PHP免费学习笔记（深入）”；
$input = escapeshellarg('/var/www/videos/demo.mp4');
$output = escapeshellarg('/var/www/thumbs/demo.jpg');
$cmd = "ffmpeg -ss 5 -i {$input} -vframes 1 -q:v 2 {$output} 2>&1";
$result = shell_exec($cmd);
if (strpos($result, 'error') !== false || !file_exists($output)) {
// 处理失败
}
获取视频时长与分辨率：解析 ffprobe JSON 输出
前端常需预知视频尺寸或总时长来控制布局或进度条。不要用正则匹配文本输出，直接让 ffprobe 输出 JSON 更可靠：
-
ffprobe是 FFmpeg 套件中专用于分析媒体信息的工具，必须与 FFmpeg 同版本共存 - 使用
-v quiet -print_format json -show_entries精确指定字段，避免冗余解析 - PHP 的
json_decode()可直接转换结果，但注意shell_exec返回含换行符，需trim()
ffprobe -v quiet -print_format json -show_entries format=duration:stream=width,height -of default=nw=1 input.mp4
更稳妥的 JSON 格式调用：
$cmd = "ffprobe -v quiet -print_format json -show_entries format=duration:stream=width,height -of json {$input}";
$output = trim(shell_exec($cmd));
$info = json_decode($output, true);
$duration = (float) ($info['format']['duration'] ?? 0);
$width = (int) ($info['streams'][0]['width'] ?? 0);
转码为 Web 兼容格式：注意 -c:v libx264 和 -c:a aac
用户上传的 MP4 可能用 HEVC（H.265）编码，Safari 以外多数浏览器不支持。必须转为 H.264 + AAC 组合：
- 强制指定编码器：
-c:v libx264（不能只写-vcodec，旧参数可能失效） - 音频必须重编码为
aac，MP3 在部分新版 Chrome 中已被弃用 - 加
-movflags +faststart把 moov box 移到文件头，实现“边下边播”，否则 HTML5会卡住直到下载完 - 转码耗时长，务必设超时（
set_time_limit(0)）并异步处理，避免 HTTP 超时
ffmpeg -i input.mov -c:v libx264 -c:a aac -movflags +faststart output.mp4
FFmpeg 命令看似简单，但路径权限、参数顺序、编码兼容性、错误静默这几个点，任一出错都会让 PHP “看起来没反应”。别信“执行成功”就等于文件生成了，每次都要校验输出文件是否存在、是否可读、是否为合法 MP4。
