PHP 本身不直接处理视频编码,所谓“PHP 视频转 MP4”实际是调用 ffmpeg 命令行工具完成的;设置 preset 的关键在 ffmpeg 参数中,必须显式指定 -c:v libx264 -preset(如 fast),且需校验值合法性、防命令注入、捕获错误输出。

PHP 本身不直接处理视频编码,所谓“PHP 视频转 MP4”实际是调用 ffmpeg 命令行工具完成的。设置 preset 的关键不在 PHP 代码里,而在你拼写的 ffmpeg 参数中——选错 preset 会导致转码慢、体积大或画质崩坏。
preset 是什么?为什么不能随便填
preset 是 FFmpeg 内置的一组编码参数组合,控制压缩速度与质量的权衡。它不是 PHP 函数参数,也不是某个 PHP 扩展的配置项,而是传给 libx264(H.264 编码器)的选项。填错值(比如写成 fastest 或 ultra)会直接报错:Unknown option 'preset' 或 Invalid argument。
-
ultrafast:几乎不压缩,速度快但文件巨大,适合临时预览 -
superfast–veryfast:适合批量转码、对延迟敏感的场景(如实时剪辑预处理) -
faster–fast:平衡点,大多数 Web 上传/播放场景推荐用fast -
medium(默认):不显式指定时的 fallback,兼容性好但不一定最优 -
slow–veryslow:压缩率高、文件小,但耗时翻倍,适合归档或离线分发
PHP 中调用 ffmpeg 设置 preset 的正确写法
必须通过 exec() 或 shell_exec() 拼接完整命令,-preset 参数要放在 -c:v libx264 后、输入输出路径前。顺序错或漏掉 -c:v libx264 会导致 preset 被忽略(FFmpeg 默认可能走其他编码器)。
示例(安全拼接,防 shell 注入):
立即学习“PHP免费学习笔记(深入)”;
$input = escapeshellarg('/path/to/input.avi');
$output = escapeshellarg('/path/to/output.mp4');
$preset = 'fast'; // 只能是官方支持的字符串
$cmd = "ffmpeg -i {$input} -c:v libx264 -preset {$preset} -c:a aac -movflags +faststart {$output} 2>&1";
$result = shell_exec($cmd);
- 务必显式指定
-c:v libx264,否则-preset对 H.265 或 VP9 无效 -
-movflags +faststart让 MP4 支持流式播放,和 preset 无关但常被一起加 - 不要用变量直接拼接路径或文件名,必须用
escapeshellarg() - 加
2>&1捕获错误输出,否则失败时 PHP 看不到原因
常见失败现象和排查方向
执行后输出为空、MP4 播放不了、文件大小异常,大概率是 preset 相关配置没生效。
- 错误信息含
Option preset not found→ 说明-preset写在了错误位置(比如放在-i前,或没跟libx264绑定) - 转码极慢但文件没变小 → 实际用了
medium(默认),而你以为设成了slow;用ffmpeg -h encoder=libx264查看当前版本支持的 preset 列表 - 生成的 MP4 在 Safari 打不开 → 可能 preset 配合了不兼容的 profile(如
highprofile),需加-profile:v baseline保兼容 - PHP 脚本卡住无响应 →
exec()被阻塞,检查是否漏了2>&1导致 stderr 未捕获,或 preset 过慢触发超时
真正起作用的是 ffmpeg 命令里的 -preset,PHP 只是管道。别在 php.ini 或扩展配置里找 preset 设置项——它根本不存在。确认你用的 ffmpeg 版本支持你要的 preset(旧版可能不支持 ultrafast),再检查命令拼接逻辑是否把参数送进了正确的上下文。



















