php批量处理视频需调用ffmpeg,必须用escapeshellarg()转义路径、glob精确匹配格式、按场景精简参数、检查stderr关键词判断失败、控制并发防oom。

PHP本身不直接处理视频,批量视频操作必须调用外部工具(主要是 ffmpeg),脚本只是调度器;写错路径、忽略错误码、不转义文件名,三者任一都会让整个批量任务静默失败或只处理部分文件。
php exec() 调用 ffmpeg 时必须 escapeshellarg()
直接拼接变量进命令行是高危操作——文件名含空格、括号、单引号时,exec() 会截断或执行意外命令。比如 $file = "my video (2024).mp4",不加防护会导致 ffmpeg 只读到 my 就报错。
- 正确做法:所有路径和文件名必须包裹
escapeshellarg(),例如escapeshellarg($file)和escapeshellarg($outputFile) - 错误示范:
"ffmpeg -i $file -vn $outputFile"—— 绝对不要这么写 - 额外建议:在命令末尾加
2>&1,把 stderr 合并进输出,方便捕获 ffmpeg 的具体报错(如编解码器不支持、权限拒绝)
批量处理前先用 glob() 精确匹配目标格式
glob() 是 PHP 原生最轻量的文件筛选方式,但通配符容易误伤或漏掉。视频格式多变,仅靠 *.mp4 不够,且 Windows 下大小写不敏感而 Linux 敏感。
- 推荐写法:
glob($directory . '/{*.mp4,*.avi,*.mov,*.mkv}', GLOB_BRACE | GLOB_CASEINSENSITIVE)(Linux/macOS 需手动处理大小写,GLOB_CASEINSENSITIVE仅 PHP 8.2+ 支持) - 更稳妥方案:用
DirectoryIterator+finfo检查真实 MIME 类型,避免伪装成 .mp4 的恶意文件 - 注意:
glob()不递归子目录;需递归请改用RecursiveDirectoryIterator,否则子目录里的视频会被跳过
ffmpeg 命令参数要按场景精简,别无脑套用模板
同一句 ffmpeg 命令在不同视频上表现差异极大:有的卡在关键帧提取,有的因分辨率太高 OOM,有的音频流缺失导致 -ab 失效。参数不是越多越好,而是按目的裁剪。
- 抽缩略图(封面):
ffmpeg -i {input} -ss 00:00:05 -vframes 1 -q:v 2 {output}.jpg——-ss放前面快,-q:v 2控制画质(2 最佳,32 最差) - 转 MP3(纯音频):
ffmpeg -i {input} -vn -acodec libmp3lame -ar 44100 -ac 2 -b:a 192k {output}.mp3—— 显式指定libmp3lame编码器,避免系统默认编码器不一致 - 转码为 Web 兼容 MP4:
ffmpeg -i {input} -vcodec libx264 -preset fast -crf 23 -acodec aac {output}.mp4——-crf 23是视觉无损与体积的平衡点,-preset fast适合批量,别用slow
失败处理不能只靠 return_var === 0
exec() 的 $return_var 仅反映进程退出码,但 ffmpeg 即使失败也可能返回 0(尤其加了 -y 强制覆盖后)。真正可靠的判断依据是输出内容里是否含 error、failed 或 Invalid data 等关键词。
- 务必同时检查
$output数组内容:if ($return_var !== 0 || strpos(implode("\n", $output), 'error') !== false) - 记录失败详情:把
$output和完整命令写入日志,否则下次排查时只能干瞪眼 - 单文件失败不影响整体:循环内用
continue跳过当前项,别让一个坏文件中断全部处理
最容易被忽略的是 ffmpeg 进程资源占用——批量跑 10 个 2GB 视频,内存瞬间飙高,可能触发 OOM killer 杀掉 PHP 进程。实际部署时,必须用 proc_open() 控制并发数,或改用队列(如 Redis + Worker)分批执行,而不是一个脚本全吞下去。
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!











