php-ffmpeg不支持视频防抖，因其未封装需两阶段执行且依赖中间文件（如transforms.trf）的vidstabdetect与vidstabtransform高级滤镜链；硬编码调用FFmpeg命令并严格管控路径、权限、错误捕获才是实际可行解法。
PHP 本身不支持视频防抖，必须依赖 FFmpeg 的 vidstabdetect 和 vidstabtransform 滤镜链；直接调用命令行是唯一可行路径，php-ffmpeg 库目前不封装去抖逻辑，硬编码调用才是实际解法。
为什么 php-ffmpeg 不能直接做视频防抖
php-ffmpeg 是对 FFmpeg 命令的面向对象封装，但它只覆盖了高频操作（截图、转码、水印、缩放等），vidstabdetect 和 vidstabtransform 属于高级滤镜组合，需两阶段执行且依赖中间文件（如 transforms.trf），库未提供对应 Filter 类或流程抽象。强行用 $video->filters()->custom(...) 拼接易出错，也不便于错误捕获与进度控制。
常见误操作包括：
- 试图用单条
ffmpeg -i input.mp4 -vf "vidstabtransform=..." output.mp4直接运行——会报错No transform file found - 忽略临时文件权限，导致 PHP 进程无法写入
transforms.trf - 未清理中间文件，多次运行后磁盘被大量
.trf占满
PHP 中安全调用 vidstabdetect + vidstabtransform 的关键步骤
必须拆成两个独立命令，且确保第二步能读到第一步生成的 .trf 文件。路径、权限、超时、错误捕获缺一不可。
立即学习“PHP免费学习笔记（深入）”；
- 使用
escapeshellarg()包裹所有路径变量，防止命令注入（尤其当文件名含空格或中文时） - 第一阶段命令必须显式指定
result参数，例如：ffmpeg -i {$input} -vf vidstabdetect=shakiness=7:result=stabilize.trf -f null - - 第二阶段命令中
input参数值必须与第一阶段result一致，且该文件需在 PHP 进程有读权限的目录下（推荐放在上传视频同级的stabilize/子目录） - 用
exec(..., $output, $returnCode)而非shell_exec()，便于检查$returnCode !== 0并打印$output定位错误（如Permission denied或No such file） - 设置合理超时（建议至少 600 秒），防抖分析耗时远高于普通截图
Linux 与 Windows 下路径和权限的实际差异
FFmpeg 在 Windows 上通常可直接调用 ffmpeg.exe，但 Linux 下常遇到权限问题：Web 服务器用户（如 www-data 或 nginx）默认无权执行 /usr/bin/ffmpeg，或无法写入目标目录。
- 确认 FFmpeg 可执行：运行
sudo -u www-data ffmpeg -version，若报错“Permission denied”，需修复二进制文件权限或改用绝对路径+sudo NOPASSWD 配置（不推荐） - 中间文件目录必须可写：
stabilize/目录需chown www-data:www-data且chmod 755，不能依赖upload_tmp_dir - Windows 路径中的反斜杠
在 PHP 字符串中需双写为\，或统一用正斜杠/（FFmpeg 支持） - Linux 下若用 SELinux，还需检查布尔值：
getsebool httpd_can_network_connect，防抖过程可能触发网络连接检测（尽管不联网，但部分 FFmpeg 构建版本会尝试）
防抖参数调优的真实影响
shakiness、accuracy、stepsize 不是越大越好，需按原始视频特性平衡效果与耗时：
-
shakiness=7适合骑行/手持剧烈抖动；shakiness=4更适合轻微走路晃动，设太高会导致画面裁剪过多、边缘黑边严重 -
accuracy=15（默认）精度高但慢；实测accuracy=9对 1080p 视频已足够，耗时降低约 40% -
stepsize=6（默认）较均衡；设为12可提速，但对高频微抖识别能力下降 -
smoothing=30在vidstabtransform阶段决定稳定平滑度，值太小（如 10）残留抖动，太大（如 60）会使运动镜头显得“果冻感”过重
真正容易被忽略的是：防抖必然导致画面缩放与平移，最终输出分辨率会略小于输入——必须用 -vf scale=... 显式重设尺寸，否则 FFmpeg 默认保持原始宽高，黑边会被保留而非填充。
