php转mp4怎么设置帧率_调整php生成mp4视频帧率说明【说明】

PHP无法直接设置视频帧率，必须通过调用ffmpeg命令行工具并传入-r参数实现；-framerate仅用于输入源，-r才控制输出帧率；需校验并转义用户输入的fps值，防止命令注入，并处理超时与错误。

PHP 本身不能直接转 MP4 或设置帧率——它没有内置视频编码能力。所谓“PHP 转 MP4”，实际是调用外部命令行工具（最常见的是 ffmpeg），通过 exec()、shell_exec() 等函数执行系统命令来完成。帧率（-r 参数）必须在 ffmpeg 命令中显式指定，PHP 只负责拼接和触发。

为什么 PHP 里设不了帧率？

PHP 是脚本语言，不是多媒体框架。它不解析视频流、不控制编码器参数。所有帧率、码率、分辨率等底层控制，都由 ffmpeg 进程承担。PHP 中的变量（比如 $fps = 30）只是用来拼进命令字符串，真正起作用的是传给 ffmpeg 的 -r 或 -framerate 参数。

ffmpeg -r 和 -framerate 到底怎么选？

这两个参数语义不同，用错会导致输出帧率异常或静止画面：

• -framerate：仅用于输入（input option），告诉 ffmpeg “源数据以多少帧/秒提供”，常见于图片序列（如 img%03d.png）或摄像头设备
• -r：可用于输入或输出（output option），但作为输出参数时，它强制重采样帧率（即“写入 MP4 时每秒写几帧”），这才是你真正需要的
• 如果从图片生成 MP4，典型写法是：ffmpeg -framerate 10 -i img%03d.png -r 25 output.mp4 —— 前者表示每秒读 10 张图，后者表示最终视频以 25fps 编码

PHP 调用时怎么安全传入帧率？

直接拼接用户输入的 $fps 极易引发命令注入。必须校验并转义：

• 只允许数字（含小数点），且限制范围（如 1–60）：if (!preg_match('/^\d+(\.\d+)?$/', $fps) || $fps 60) { die('Invalid fps'); }
• 用 escapeshellarg() 包裹值，哪怕它是数字：$cmd = "ffmpeg -i {$input} -r " . escapeshellarg($fps) . " {$output}";
• 避免用 exec() 直接返回完整输出；建议重定向 stderr 并检查退出码：

  exec("ffmpeg -i {$input} -r " . escapeshellarg($fps) . " {$output} 2>&1", $output_lines, $return_code);
  if ($return_code !== 0) {
      error_log("FFmpeg failed: " . implode("\n", $output_lines));
  }

常见帧率相关错误现象与排查

输出视频卡顿、加速、音画不同步，大概率是帧率参数误用：

• 用 -framerate 替代 -r 输出 → 视频时长正常但播放卡顿（ffmpeg 没重采样，只是按原始节奏塞帧）
• 输入是视频文件却加了 -framerate → ffmpeg 报错 “Option framerate not found”
• 未指定 -vsync → 音画不同步，尤其在帧率变换时；建议加 -vsync vfr（可变帧率）或 -vsync cfr（恒定帧率）
• PHP 进程被超时中断（默认 max_execution_time=30）→ 视频只生成几秒就中断；需临时设为 set_time_limit(0)，并确保 web 服务器（如 Nginx）也放宽超时

PHP 不参与帧率计算，也不缓存视频帧。它只是个“命令调度员”。真正决定帧率的是你传给 ffmpeg 的那个 -r 值，以及输入源本身的节奏是否匹配。别在 PHP 层做“帧率转换”的幻想，该交出去的，就得交得干净、校验到位、超时可控。