PHP视频文件处理队列异步执行与任务调度【架构设计】

在视频处理场景中，一个常见的架构陷阱是：直接在 Web 请求里exec()跑 FFmpeg。这看似简单，实则隐患重重。带来的后果往往是一连串的——PHP 进程长时间阻塞，Nginx 直接报 504，FPM worker 被独占，stderr 输出丢失，并发一上来 CPU 直接拉满引发雪崩。正确的做法应该是：上传后立即返回 202 Accepted，让独立的 Worker 异步消费队列去执行转码。

为什么不能在上传接口里直接 exec() 调 FFmpeg

直接在 Web 请求中调用 exec() 执行 ffmpeg 是最偷懒的做法，也是最危险的做法。用户上传一个 2GB 视频，PHP 进程就会卡住 10–30 分钟，期间：Nginx 报 504 Gateway Timeout；PHP 的 max_execution_time（默认 30 秒）早超时；FPM worker 被独占，其他请求全部排队；stderr 输出容易丢失，失败了连日志都看不到。

更隐蔽的问题是并发——5 个用户同时上传，就可能拉满 CPU，后续所有任务全卡在“queued”状态，形成雪崩。这不只是性能优化问题，而是架构设计上的根本错误。

• Web 层只负责接收、校验、写入任务记录，必须在 200ms 内返回 202 Accepted
• 转码逻辑和 PHP 生命周期彻底解耦，哪怕 Worker 崩溃，也不影响上传接口可用性
• FFmpeg 进程应由独立常驻进程（Worker）启动，而非 PHP-FPM 子进程

Redis List + BRPOP 实现轻量级队列的实操要点

不用 RabbitMQ 也能跑通生产级视频队列，Redis List 是最快落地的选择。关键不是“能不能用”，而是怎么避免踩坑。

用 LPUSH 入队、BRPOP 阻塞消费是基础，但真实场景下必须加这几层控制：

• 任务 payload 必须包含完整上下文：original_path、target_resolution、output_disk、callback_url，而不是只传个 ID 让 Worker 去查库
• BRPOP 超时时间建议设为 0（永久阻塞），避免轮询浪费 CPU；但 Worker 启动时要先检查 Redis 连接是否存活，否则会静默退出
• 每个 Worker 进程处理完一个任务后，必须显式调用 fflush(STDOUT) 和 gc_collect_cycles()，否则内存缓慢泄漏，跑两天就 OOM
• 不要用 json_encode() 直接序列化含二进制或特殊字符的路径，建议先 base64_encode() 再存，出队后再 decode

PHP-FFMpeg 库的参数陷阱与安全边界

PHP-FFMpeg 不是封装层，它只是帮你拼命令行。底层仍是调 ffmpeg，所以参数语义、版本兼容、错误捕获一点都没少。

最容易翻车的几个点：

• 不显式指定 ffmpeg.binaries 路径，可能调到系统自带的老旧版本（比如 Ubuntu 自带的 3.x），导致 -hls_list_size 不识别或 scale=1280:-2 报错
• clip->export()->toDisk('hls') 这种链式调用一旦失败，堆栈里根本看不出原始命令是什么，调试只能靠日志打点；建议每步前加 echo $ffmpeg->getCommand();
• 缩放写 -s 1280x720 会导致黑边，必须用 -vf "scale=1280:-2" 或 -vf "scale=-2:720" 保持宽高比
• HLS 切片必须配 -hls_list_size 10，否则 -hls_list_size 0 会让分片无限累积，磁盘几天就爆

任务状态持久化与失败兜底机制

状态不能只存在内存或 Redis 中——Worker 挂了，任务就丢了；也不能只靠前端轮询 /api/task/123/status，那是给服务器添堵。

真正可靠的方案是：

• 状态字段至少有四态：queued → processing → completed / failed，数据库里用 TINYINT 或枚举类型存，别用字符串
• 失败时必须存完整 ffmpeg 的 stderr 输出（截断前 4KB 即可），不然重试时连错在哪都不知道
• Worker 启动时检查是否有 processing 状态超过 10 分钟的任务，自动标为 failed 并触发重试（最多 2 次）
• 用 Redis Pub/Sub 推送完成事件，前端监听 task:completed:123，而不是自己发请求

最易被忽略的是路径管理：数据库里别存 /var/www/storage/videos/xxx.mp4 这种绝对路径，统一用相对路径 + CDN 域名前缀，否则换服务器或上 K8s 就全挂。