17370845950

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 可以边读边处理。

• 必须显式设置 stdout 和 stderr 管道，并循环 fgets() 读取
• 注意资源释放：用完后要 fclose() 管道、proc_close() 进程，否则可能泄漏句柄
• 超时控制靠 stream_select() 或外部计时器，PHP 默认无命令级 timeout 参数

常见失败原因和绕过方式

不是所有问题都能靠改 PHP 解决，得知道边界在哪。

• Permission denied：不是 PHP 权限问题，而是目标目录属主/SELinux/容器挂载权限限制，改 chown 或调整上下文比硬编码 s

  

  udo 安全得多
• 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 里能回显，再谈其它。