PHP仅调度监控，ffmpeg负责实际转码；必须异步执行、记录任务状态、用-progress输出JSON进度日志，并结构化记录错误归因。
PHP 本身不转码，只调度和监控
PHP 没有内置视频编解码能力，ffmpeg 才是实际干活的。PHP 的角色是：接收请求 → 校验参数 → 启动后台转码进程 → 记录状态 → 提供进度查询接口。强行在 PHP 进程里用 exec() 同步跑 ffmpeg 会导致超时、阻塞、内存溢出，必须异步化。
用 proc_open() 或队列启动 ffmpeg 命令
推荐用 proc_open() 精确控制子进程（尤其需捕获错误输出），避免 shell_exec() 隐藏失败。关键点：
-
ffmpeg命令必须带完整路径（如/usr/bin/ffmpeg），不能依赖$PATH - 输出重定向到文件（如
-loglevel quiet -y /tmp/output.mp4），避免 stdout/stderr 堆积阻塞 - 设置超时（
stream_set_timeout()）和资源限制（setrlimit()）防失控 - 转码命令末尾加
&不够可靠，应配合nohup或交由队列系统（如 Redis +php-resque）
proc_open(
'/usr/bin/ffmpeg -i /tmp/input.mp4 -c:v libx264 -preset fast -crf 23 -c:a aac /tmp/output.mp4 2>/tmp/ffmpeg.log',
[
['pipe', 'r'],
['pipe', 'w'],
['pipe', 'w']
],
$pipes,
'/tmp',
$_ENV
);
必须记录任务 ID 和状态，别靠轮询文件存在
用户请求后返回一个唯一 $task_id（如 uniqid('transcode_')），所有状态存数据库或 Redis，字段至少包含：status（pending/running/success/failed）、input_path、output_path、error_log、created_at、updated_at。不要用 file_exists() 判断是否完成——文件可能写一半就中断，也难定位失败原因。
- 启动转码前先插入
pending记录 - 子进程退出后，用
proc_get_status()或信号回调更新状态 - 失败时把
/tmp/ffmpeg.log内容读入error_log字段，方便排查（常见如No such file or directory、Invalid data found when processing input）
前端轮询进度？不如让 ffmpeg 输出 JSON 日志
ffmpeg 从 4.3 开始支持 -progress 输出机器可读进度（JSON 或 KV 格式）。PHP 可开一个独立日志文件，让 ffmpeg 实时写入，再由另一个轻量接口读取最新行解析：frame=1234 fps=24.5 q=23.0 size=12345kB time=00:00:56.78 bitrate=1234.5kbits/s。比估算耗时或查文件大小靠谱得多。
立即学习“PHP免费学习笔记（深入）”；
- 命令中加
-progress /tmp/transcode_abc123.progress - PHP 接口用
tail -n 1 /tmp/transcode_abc123.progress或fseek($fp, -1024, SEEK_END)读末尾几行 - 注意并发请求时 progress 文件名必须唯一，且要处理文件未生成或权限问题（
is_readable()必须校验）
ffmpeg 版本太低不支持某参数？每种情况对应的日志特征和应对方式完全不同，得靠结构化记录和分类提取错误关键词来快速定位。 
