PHP 8.4 下视频加水印失败主因是 ffmpeg 调用链异常，非版本不兼容：常见为 ffmpeg 路径错误、权限不足、SELinux 限制、stderr 未重定向（需加 2>&1）、超时或编码器过时（如 libfaac 已废弃），应强制绝对路径、检查返回值、升级 php-ffmpeg 或改用 exec() 直接调用。
ffmpeg 命令执行失败是 PHP 8.4 下视频加水印生成失败的最常见原因，不是 PHP 版本本身不支持，而是调用链中某个环节被新版本更严格的执行环境暴露出来。
exec() 或 shell_exec() 返回空或报错码 127
PHP 8.4 不改变命令执行机制，但默认更倾向关闭输出缓冲、更早暴露错误。若 ffmpeg 命令根本没运行起来，大概率是：
-
ffmpeg未安装，或不在系统PATH中（尤其 Docker 或精简版 Linux） - 使用了相对路径（如
./ffmpeg），而 PHP 工作目录不可控（CLI 和 Web 环境不同） - SELinux 或 AppArmor 阻止了 PHP 进程调用外部二进制
- Web 服务器用户（如
www-data）无权访问ffmpeg文件或临时目录
建议做法：
- 用
which ffmpeg或/usr/bin/which ffmpeg在 PHP 中先探测路径 - 强制使用绝对路径：比如
/usr/local/bin/ffmpeg - 检查返回值：
$output = shell_exec('ffmpeg -version 2>&1'); if (empty($output)) { /<em> 失败 </em>/ } - 在 CLI 下用同用户（如
sudo -u www-data /usr/bin/ffmpeg -version）复现问题
PHP-FFMpeg 报 Encoding failed 或 Unknown encoder 'libfaac'
这是历史遗留坑，在 PHP 8.4 下因依赖库版本更严格而高频触发：
立即学习“PHP免费学习笔记（深入）”；
-
libfaac已被 FFmpeg 官方移除多年，但旧版PHP-FFMpeg（如 v0.19 及更早）仍硬编码该编码器 - 新版 FFmpeg 默认只认
libfdk_aac或aac（内置 AAC 编码器） - 即使你本地
ffmpeg -version显示支持libfdk_aac，PHP 扩展仍可能传错参数
解决方式：
- 升级到
php-ffmpeg/php-ffmpegv3.0+（已弃用硬编码编码器） - 或手动覆盖音频编码器：
$format = new X264('aac', 'libx264'); - 或绕过封装，直接用
exec()调用带明确参数的命令（更可控）
示例安全命令：
ffmpeg -i input.mp4 -i watermark.png -filter_complex "overlay=W-w-20:H-h-20" -c:v libx264 -c:a aac -b:a 128k output.mp4
注意：不要用 -c:a copy 除非确认源音频编码与目标容器完全兼容，否则易导致 MP4 封装失败。
timeout 触发或内存耗尽，但没报错
PHP 8.4 默认 max_execution_time 仍为 30 秒，而一个 5 分钟视频加水印可能需 40+ 秒（尤其无硬件加速时）。更麻烦的是：超时后进程可能被 kill，但 PHP 不一定抛出异常，exec() 只返回空。
关键点：
-
set_time_limit(0)必须在exec()前调用（且确保未启用safe_mode，该模式 PHP 8.4 已彻底移除） - 更稳妥用
proc_open()，可设timeout并捕获 stderr 实时日志 - 检查临时目录空间和 inodes：水印过程会生成帧缓存或 pass 日志，
/tmp满会导致静默失败
真正容易被忽略的是：PHP 8.4 对错误报告更敏感，而 FFmpeg 错误常输出到 stderr，不是 stdout。shell_exec() 默认不捕获 stderr，所以你看不到 “No such file or directory” 或 “Invalid pixel format”，只会得到空结果。必须显式重定向：2>&1，否则连调试入口都没有。
