PHP 8.5 无法直接处理视频水印，必须调用 ffmpeg；关键在于正确拼接命令、归一化视频参数（SAR/旋转）、精准计算 overlay 坐标，并确保中文字体与编码适配。
PHP 8.5 本身不能自动给视频加水印——它连视频帧都解不开。真正干活的是 ffmpeg，PHP 只负责拼命令、调用、等结果、清临时文件。所谓“自动”，其实是把水印逻辑塞进上传流程里，且必须绕过 GD/Imagick 这类纯图像扩展。
exec() 调用 ffmpeg 是最直接可控的方式
shell_exec() 或 proc_open() 都行，但别用 system() 或裸 exec() 不捕获输出——你无法判断是卡住、超时，还是水印根本没贴上。
- 常见错误现象：命令执行完没报错，但输出视频打开后水印偏移、拉伸、消失或全黑
- 根本原因不是 PHP 写错了，而是
ffmpeg输入流的 SAR（采样宽高比）、旋转元数据、alpha 通道处理没对齐 - 实操建议：
- 所有路径必须用
escapeshellarg()包裹：escapeshellarg($inputPath)、escapeshellarg($watermarkPath) - 强制归一化尺寸和旋转：在滤镜链开头加
scale=trunc(iw/2)<em>2:trunc(ih/2)</em>2,setsar=1，再跟transpose=0（清除 rotate 元数据） - 图片水印务必用 PNG + alpha 通道，避免黑底；文字水印字体路径不能含空格或中文，Linux 下推荐
/usr/share/fonts/truetype/noto/NotoSansCJK-Regular.ttc - 设置超时：
set_time_limit(300)，并用proc_open()捕获 stderr 判断是否真失败（比如Invalid argument to overlay）
- 所有路径必须用
overlay 坐标写错是水印“消失”最常见原因
overlay 表达式里大小写敏感：大写 W/H 是主视频尺寸，小写 w/h 是水印图尺寸。写反了就会偏出画面。
- 错误写法：
overlay=x=w-w-10:y=H-h-10→ x 恒为 -10，水印死贴左边界外 - 正确写法：
overlay=x=W-w-10:y=H-h-10（右下角，10px 边距） - 动态居中写法：
overlay=x=(W-w)/2:y=(H-h)/2 - 若需适配不同分辨率视频，别硬编码像素值，先用
ffprobe提取宽高：ffprobe -v quiet -show_entries stream=width,height -of csv=p=0 input.mp4 - 注意：手机竖屏视频常带
rotate=90元数据，不处理会导致你量的坐标和 ffmpeg 实际贴的位置差 90°，必须显式transpose=0或rotate=0
文字水印中文乱码？问题不在 PHP 编码，而在字体与表达式
drawtext 的 text= 参数若含中文，必须同时满足三个条件：
立即学习“PHP免费学习笔记（深入）”；
- 字体文件本身支持 UTF-8（如
NotoSansCJK，别用simhei.ttf在 Linux 上） -
fontfile=路径是绝对路径，且无空格（Windows 下可用C:\Windows\Fonts\simhei.ttf，但 Linux 必须用正斜杠） -
text=值要 URL 编码或 shell 转义：比如text='版权%E2%84%A22026'或text='版权\™2026'（Linux 下反斜杠转义更稳） - 时间戳中文显示：
text='%{localtime:%Y年%m月%d日\ %H\:%M\:%S}'，注意冒号和空格都要加反斜杠
别指望 iconv('UTF-8', 'GBK', $text) 解决问题——那是 Windows CMD 环境的老办法，ffmpeg 本身按 UTF-8 解析，强行转 GBK 只会让字变成方块。
关键点就这三块：命令得拼对、坐标得算准、中文得喂对。最容易被忽略的是旋转元数据和 SAR 归一化——哪怕命令能跑通，手机拍的视频十有八九会偏。别省那两行 transpose=0,setsar=1。
