PHP调用FFmpeg需满足三条件:exec等函数未被禁用、FFmpeg在PATH中、PHP进程有文件读写权限;须用escapeshellarg()防注入,捕获stderr诊断错误,大文件宜用proc_open配合异步处理。

PHP 本身不直接处理视频,调用 FFmpeg 必须走系统命令行;能否成功,核心取决于 exec 等函数是否启用、FFmpeg 是否在系统 PATH 中、PHP 进程是否有对应文件读写权限。
确认 PHP 能否执行 shell 命令
很多生产环境禁用 exec、shell_exec、system 等函数,这是第一步卡点。
- 检查
disable_functions配置:运行phpinfo()或执行ini_get('disable_functions'),确认列表里不含exec - 简单测试:
echo shell_exec('which ffmpeg 2>&1');若返回空或“command not found”,说明要么没装 FFmpeg,要么不在 PATH,要么函数被禁用 - Web 服务器(如 Nginx/Apache)下运行的 PHP 进程用户(如
www-data或nginx)必须对输入视频、输出目录有读写权限
用 shell_exec 调用 FFmpeg 命令要加错误捕获
直接拼接字符串调用容易静默失败——比如路径含空格、中文未转义、参数顺序错,FFmpeg 报错但 PHP 不抛异常。
- 始终用
2>&1合并 stderr 到 stdout,方便捕获错误:$output = shell_exec('ffmpeg -i "/path/to/input.mp4" -vf "scale=640:360" "/path/to/output.mp4" 2>&1'); - 检查返回值是否为
null(函数被禁)或包含error/Invalid等关键词,不能只看空不空 - 避免用户输入直插命令:用
escapeshellarg()包裹路径和关键参数,例如:escapeshellarg($inputPath)
proc_open 更适合长耗时或需实时反馈的场景
当处理大视频、需要监听进度(如解析 FFmpeg 的 frame=... 输出)、或防止超时时,shell_exec 会阻塞直到结束,而 proc_open 可以边读边处理。
基于PHP+MYSQL开发,除了网上书店必备的商品管理、配送支付管理、订单管理、会员分组、会员管理、查询统计和多项商品促销功能,还具有完整的文章、图文、下载、单页、广告发布等网站内容管理功能。系统具有静态HTML生成、UTF-8多语言支持、可视化模版引擎等技术特点,支持多频道调用不同模版和任意设置频道首页,适合建立各种规模的网上书店。系统具有以下主要功能模块: 网站参数设置 - 对网站的一些参数进
立即学习“PHP免费学习笔记(深入)”;
- 必须显式设置
stdout和stderr管道,并循环fgets()读取 - 注意资源释放:用完后要
fclose()管道、proc_close()进程,否则可能泄漏句柄 - 超时控制靠
stream_select()或外部计时器,PHP 默认无命令级 timeout 参数
常见失败原因和绕过方式
不是所有问题都能靠改 PHP 解决,得知道边界在哪。
-
Permission denied:不是 PHP 权限问题,而是目标目录属主/SELinux/容器挂载权限限制,改chown或调整上下文比硬编码sudo安全得多 -
Unable to find a suitable output format:通常因输出路径扩展名与实际编码格式不匹配(如用.mp4但用了-f webm),统一用-c:v libx264 -c:a aac显式指定编解码器更稳 - Web 环境下大文件上传后立即转码失败:PHP
upload_max_filesize和post_max_size限制的是上传阶段,但转码过程仍受memory_limit和max_execution_time影响,建议异步队列处理
FFmpeg 调用看着是 PHP 一行命令,实际成败往往卡在系统层权限、路径语义、错误流捕获这三处;别急着封装类,先确保 which ffmpeg 在 PHP 里能回显,再谈其它。










