php-ffmpeg 1.4.0 彻底移除 watermark() 方法，改用 addwatermark($watermarkpath, $positionx, $positiony)，坐标须为 ffmpeg 表达式（如 'w-w-30'），不支持数组配置、自动转换或动态滤镜，mp4 水印需显式设 shortest=0。
watermark() 方法签名已移除，改用 addWatermark()
PHP-FFMpeg 1.4.0 彻底废弃了 watermark() 方法，调用会直接抛出 BadMethodCallException。这不是兼容性警告，而是硬性删除——源码里已找不到该方法定义。升级后所有旧代码都会中断，必须重构。
新接口是 addWatermark()，它不接受数组配置，只接收三个参数：$watermarkPath、$positionX、$positionY，且坐标单位是像素（非百分比或“right=20”这类语义化描述）。
- 旧写法（1.3.1）：
$video->filters()->watermark($img, ['position' => 'relative', 'right' => 30, 'bottom' => 30]) - 新写法（1.4.0）：
$video->filters()->addWatermark($img, 'W-w-30', 'H-h-30')
注意：'W-w-30' 是字符串表达式，不是 PHP 数值计算；FFmpeg 在运行时解析它，所以必须用单引号包裹，避免提前被 PHP 解析成负数。
相对坐标要手动写成 FFmpeg 表达式，不能依赖库自动转换
1.3.1 版本里传 ['right'=>50]，库内部会帮你算成 x=W-w-50；1.4.0 不再做这层映射。你得自己把“右下角偏移 50 像素”翻译成 FFmpeg overlay 滤镜能认的表达式。
常见位置表达式对照（假设水印图宽为 w、高为 h，主视频宽为 W、高为 H）：
- 左上角：
'10'和'10' - 右上角：
'W-w-10'和'10' - 左下角：
'10'和'H-h-10' - 右下角：
'W-w-10'和'H-h-10' - 居中：
'(W-w)/2'和'(H-h)/2'
别漏掉括号，W-w/2 和 (W-w)/2 结果完全不同。FFmpeg 表达式按 C 语言规则运算，无优先级自动修正。
动态位置或缩放需显式拼进 filter_complex，addWatermark() 不支持
addWatermark() 只处理静态 PNG/JPEG 水印，且不做任何预处理。如果你原来用 1.3.1 的 watermark() 传了带 scale 或 rotate 的水印路径（比如 "scale=150:-1:flags=lanczos"），现在会失败——它只认真实文件路径，不解析 filter 链。
需要动态行为，必须绕过 addWatermark()，直接走底层 custom() 或 filter()：
php
$video->filters()->custom(
"movie={$watermarkPath}:loop=0 [wm]; [wm] scale=150:-1:flags=lanczos [wm_scaled]; [0:v][wm_scaled] overlay=W-w-20:H-h-20"
);
这里 movie= 加载水印，scale 缩放，overlay 叠加，全部写进一个 filter_complex 字符串。注意变量名（如 [wm]）要前后一致，否则 FFmpeg 报 No such filter 错误。
PHP-FFMpeg 1.4.0 默认启用 shortest=1，小心水印视频被截断
1.4.0 中 addWatermark() 底层生成的 overlay 滤镜默认加了 shortest=1，意思是“以较短输入为准”。对 PNG 水印没问题（单帧），但如果你传的是 MP4 水印视频，它会被主视频长度截断——哪怕你本意是让它循环播放。
要恢复循环行为，必须手动覆盖这个参数：
- 错误写法：
$video->filters()->addWatermark($videoWatermark, 'W-w-10', 'H-h-10')（隐式shortest=1） - 正确写法：
$video->filters()->custom("overlay=x='W-w-10':y='H-h-10':shortest=0")
shortest=0 表示不限制，水印视频会 repeat 到主视频结束；shortest=1 才是默认值。这点文档没强调，但源码里 hardcode 了 shortest=1。
真正麻烦的是：SAR 不一致、旋转元数据、alpha 通道这些老问题，1.4.0 并没帮你解决——它们从来就不是 PHP-FFMpeg 的责任，而是你传给 FFmpeg 的 filter 表达式是否严谨。升级只是换了个调用入口，底层还是 overlay 滤镜那一套。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
