PHP 8.5 升级不影响视频加水印的核心逻辑，因水印由 FFmpeg 执行，PHP 仅调用命令；需关注语言特性变化（如 create_function 删除、mixed 类型校验变严）、错误报告升级及 FFmpeg 环境依赖是否仍有效。

不用改。PHP 8.4 升级到 8.5 后，**视频加水印的代码逻辑、FFmpeg 命令拼接方式、参数写法完全不需要调整**——因为水印功能由 FFmpeg 执行，PHP 只是调用命令的“传话人”。 真正要关注的，是 PHP 8.5 对**你封装水印逻辑时所依赖的语言特性或运行环境细节**是否产生影响。下面分场景说明：

PHP 8.5 是否影响 exec()/shell_exec() 调用 ffmpeg

不影响。PHP 8.5 没有改动进程执行函数的行为，exec()、shell_exec()、proc_open() 的签名和语义与 8.4 一致。

• 你原来用 escapeshellarg($watermarkPath) 包裹路径？继续用，安全逻辑不变
• 原来设 set_time_limit(300) 防超时？仍然有效
• 原来检查 $returnCode !== 0 判定失败？规则照旧

哪些地方可能“看似要改”，其实只是旧代码隐患暴露了

升级后如果水印突然不显示、偏移、报错，大概率不是 PHP 8.5 的锅，而是旧代码里埋着的兼容性雷被触发了：

btpanel phpsite 宝塔面板PHP网站

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

下载

• create_function() 被彻底删除：如果你曾用它动态生成 overlay 表达式（比如拼 x=W-w-'. $offset .'），升级后直接 Fatal error。必须换成匿名函数或字符串拼接 —— 但这属于你代码本身不规范，不是“水印功能需要改”
• mixed 类型声明更严格：若你封装的水印类方法声明为 function addWatermark(mixed $config): void，而传入 null，PHP 8.5 会报 TypeError；但这是类型校验变严，和 FFmpeg 命令无关
• 错误报告级别提高：某些被 8.4 忽略的 notice（如未初始化的变量参与字符串拼接）在 8.5 可能升级为 warning，导致日志刷屏，但不会中断水印生成

真正该检查的三个硬性依赖点

这些和 PHP 版本无关，但升级常顺带暴露问题：

• ffmpeg 和 ffprobe 二进制路径是否仍可访问？PHP 8.5 不改环境变量，但若你升级系统或重装了 FFmpeg，路径可能失效
• 用户上传的水印图是否仍是 PNG + alpha 通道？JPG 水印 + overlay 会导致黑底，这个现象在 8.4 也存在，只是你之前没碰到
• 是否还在用已弃用的 FFmpeg 参数？例如老版本用 -vf "overlay=..."，新版本推荐 -filter_complex "overlay=..."（尤其多输入时）。PHP 版本不决定这个，但 FFmpeg 升级（比如从 4.x 到 6.x）会强化校验

最常被忽略的一点：PHP 8.5 不改变任何 shell 转义规则，但如果你把 filtergraph 表达式（比如 enable='between(t,2,8)'）直接拼进字符串又没用 escapeshellarg() 包裹，升级前后都会崩——只是 8.5 下错误信息可能更明确，让人误以为是版本问题。