PHP-FFMpeg 1.4.0 的 watermark() 方法不支持精确坐标和缩放，仅接受 bottom/right/top/left 像素偏移且不自适应分辨率，必须用 customFilter() 手动构造 overlay 表达式并配合 scale 滤镜实现。
PHP-FFMpeg 1.4.0 的 watermark() 方法不支持直接传入像素坐标或缩放参数，位置和大小由底层 FFmpeg 的 overlay 滤镜表达式决定，但该版本封装层做了硬编码限制 —— 你无法用原生 API 精确控制水印宽高或任意坐标，必须绕过封装、手动拼 filter 链。
watermark() 默认行为：只支持“相对位置”，且不缩放水印图
调用 $video->filters()->watermark($image, $relative) 时，PHP-FFMpeg 1.4.0 内部固定生成类似这样的 filter：movie=xxx.png [wm]; [in][wm] overlay=main_w-overlay_w-50:main_h-overlay_h-50（右下角偏移 50px）。它：
- 强制使用
main_w/main_h和overlay_w/overlay_h，不支持W/H/w/h变量 - 不插入
scale滤镜，水印图按原始尺寸叠加，可能过大或过小 -
$relative数组只接受bottom/right/top/left四个 key，值为像素数，不能写表达式（如'right' => 'main_w-overlay_w-20'会报错） - 所有坐标都是绝对像素值，**不随视频分辨率自适应**，1080p 和 480p 视频上水印视觉大小不一致
想设精确坐标或缩放？必须 bypass watermark()，用 customFilter()
这是唯一可靠方式。直接跳过 watermark()，用 addFilter() 或 customFilter() 注入完整 filter 表达式：
- 先用
ffprobe获取视频宽高（避免硬编码），例如：ffprobe -v quiet -show_entries stream=width,height -of csv=p=0 input.mp4 - 若需缩放水印，加
scale=200:-1到第二个输入：-i "scale=200:-1:flags=lanczos" watermark.png - 写 overlay 表达式时，**严格区分大小写**：
W/H是主视频，w/h是水印图；main_w/main_h在此版本中不可用 - 示例：右下角 20px 偏移 + 水印缩放到宽 150px：
ffmpeg -i input.mp4 -i "scale=150:-1" watermark.png -filter_complex "overlay=W-w-20:H-h-20" -c:a copy output.mp4 - PHP 中执行：
exec(escapeshellarg($ffmpegBin) . ' -i ' . escapeshellarg($input) . ' -i "scale=150:-1" ' . escapeshellarg($watermark) . ' -filter_complex "overlay=W-w-20:H-h-20" -c:a copy ' . escapeshellarg($output), $out, $returnCode)
中文路径/空格/特殊字符导致命令失败的典型表现
错误现象：Unable to find a suitable output format for 'watermark.png' 或 No such file or directory，尤其在 Windows 下。
立即学习“PHP免费学习笔记（深入）”；
-
escapeshellarg()必须包裹每个路径，包括带空格的 fontfile 或 watermark.png 路径 - Windows 下
scale=150:-1的冒号会被 cmd 当作驱动器分隔符，应改用双引号包裹整个 filter：-filter_complex "overlay=W-w-20:H-h-20" - 中文路径需确保 PHP 文件编码为 UTF-8，且系统 locale 支持（Linux 用
setlocale(LC_ALL, 'zh_CN.UTF-8')） - 避免在路径中使用
&、|、;等 shell 元字符，哪怕已 escapeshellarg —— 某些旧版 Windows cmd 仍会提前截断
实际用起来，最易被忽略的是：PHP-FFMpeg 1.4.0 的 watermark() 不校验水印图是否存在或是否可读，命令静默失败后只返回空文件。务必在调用前 file_exists() + getimagesize() 验证 PNG 是否有效，否则 debug 时只会看到输出视频没水印、也没报错。
