根本原因是未启用时间变量解析，必须用 %{localtime} 或 %{pts:hms} 配合 reload=1；PHP 中需用双引号转义、escapeshellarg() 安全拼接，并确保 FFmpeg ≥4.4（毫秒需 ≥5.0），时区取决于系统而非 PHP 设置。
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 拼接时引号嵌套、空格、特殊字符未转义导致命令被截断。
- 务必用
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 可用。
立即学习“PHP免费学习笔记（深入）”；
- 完整时间字符串推荐组合：
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 级别准确
date_default_timezone_set 并不会让 %{localtime} 变成本地时间，它只反映系统 time() 返回值；而很多 Docker 镜像默认是 UTC，却没同步宿主机时区。 
