PHP无法直接设置视频帧率，必须通过调用ffmpeg命令行工具并传入-r参数实现；-framerate仅用于输入源，-r才控制输出帧率；需校验并转义用户输入的fps值，防止命令注入，并处理超时与错误。
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)); }
常见帧率相关错误现象与排查
输出视频卡顿、加速、音画不同步，大概率是帧率参数误用：
立即学习“PHP免费学习笔记（深入）”；
- 用
-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）也放宽超时
ffmpeg 的那个 -r 值，以及输入源本身的节奏是否匹配。别在 PHP 层做“帧率转换”的幻想，该交出去的，就得交得干净、校验到位、超时可控。 
