如何用PHP结合FFmpeg为短视频自动打上动态时间水印？-php教程-PHP中文网

根本原因是未启用时间变量解析，必须用 %{localtime} 或 %{pts:hms} 配合 reload=1；php 中需用双引号转义、escapeshellarg() 安全拼接，并确保 ffmpeg ≥4.4（毫秒需 ≥5.0），时区取决于系统而非 php 设置。

如何用php结合ffmpeg为短视频自动打上动态时间水印？

PHP 调用 FFmpeg 命令时，时间水印不随帧更新？

根本原因是直接写死 -drawtext 的 text 参数，比如 text='00:00:01'，FFmpeg 不会自动刷新。必须启用时间变量解析，并确保使用 strftime=1 或 timecode 模式配合 reload=1。

动态时间需用 %{localtime}（推荐）或 %{pts:hms}，且必须加 reload=1 让每帧重求值
strftime=1 仅对 timecode 输入有效，不能和 %{localtime} 混用
PHP 中单引号字符串会原样传递，容易漏掉 : 中的反斜杠，建议统一用双引号并转义： "text='%{localtime:%H\\:%M\\:%S}'"
时区默认是 UTC，如需本地时间，在 PHP 中设 date_default_timezone_set('Asia/Shanghai')，但注意 FFmpeg 自身不读 PHP 时区，得靠 %{localtime} 底层调用系统 time() —— 所以最终取决于服务器时区

PHP exec() 执行 FFmpeg 命令失败，报错 “No such filter” 或 “Unable to parse option value”？

这类错误基本是 -drawtext 参数格式不合法，尤其在 shell 拼接时引号嵌套、空格、特殊字符未转义导致命令被截断。

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

务必用 escapeshellarg() 包裹整个 -drawtext 字符串，而不是只包其中一部分

避免手拼长参数；改用数组组装再 implode，例如：

$drawtext = sprintf(
    "fontfile=%s:fontsize=24:fontcolor=white@0.8:x=10:y=h-th-10:text='%%{localtime\:%H\\:%M\\:%S}':reload=1",
    escapeshellarg('/usr/share/fonts/truetype/dejavu/DejaVuSans.ttf')
);

检查 FFmpeg 版本：drawtext 的 %{localtime} 在 4.4+ 才稳定支持，低于此版本会报 “Unknown function” —— 可用 ffmpeg -version 验证
路径含空格或中文？escapeshellarg() 会处理，但 fontfile 必须真实存在且 PHP 进程有读取权限

时间水印位置偏移、字体模糊或渲染卡顿？

不是 PHP 问题，而是 FFmpeg 滤镜链配置不当引发的性能与渲染异常。

不要把 -drawtext 放在 -vf 链末尾还叠加其他缩放/裁剪；应优先做尺寸调整，再加水印，例如：-vf "scale=720:-2,drawtext=..."
字体过小或抗锯齿差？加 box=1:boxcolor=black@0.5:boxborderw=2 提升可读性；禁用硬件加速（如 -hwaccel none）可避免某些 GPU 驱动下文字渲染异常
批量处理多视频时 CPU 爆高？加 -threads 2 限制线程数，或用 shell_exec("nohup ffmpeg ... > /dev/null 2>&1 & echo $!") 异步跑，但要注意 PID 回收和并发控制
时间跳变（如 00:00:05 → 00:00:00）？说明输入视频 PTS 不连续，可在前面加 -vsync vfr 或用 setpts=PTS-STARTPTS 校准

PHP 中如何安全生成带毫秒的时间水印？

%{localtime} 默认不输出毫秒，而 %{pts:hms} 又依赖输入时间戳精度 —— 最可靠的方式是用 %{eif:floor(t*1000)%1000} 结合 pts 计算毫秒，但需先确保 t 可用。

完整时间字符串推荐组合：text='%%{localtime\:%H\\:%M\\:%S}.%%{eif\:floor(t*1000)%%1000}'，其中 t 是当前帧时间（秒），floor(t*1000)%1000 得到毫秒部分
注意：该表达式要求 FFmpeg ≥ 5.0；旧版可用 text='%%{pts\:hms}.%%{eif\:trunc(1000*st(0,tdiff)*ld(0))}'，但过于复杂且易错，不建议
如果只要“相对开始时间”的毫秒（如 00:00:01.234），用 text='%%{eif\:floor(t)\\:%02d}:%%{eif\:floor(1000*(t-floor(t)))}' 更稳，但需两次计算
PHP 层无法干预 FFmpeg 内部毫秒精度，最终取决于输入视频帧率和 PTS 粒度 —— 25fps 视频天然无法做到 1ms 级别准确