php无法直接播放或实时渲染带水印视频，必须通过调用ffmpeg等命令行工具离线合成水印视频，再由前端video标签播放；因其无内置音视频编解码能力，纯php处理性能差且不可靠。
PHP 本身不能直接在浏览器中“播放”带水印的视频，也不能实时渲染视频帧叠加水印——它不是音视频处理引擎。真正可行的路径是：用 PHP 调用命令行工具（如 ffmpeg）对视频文件做**离线水印合成**，生成新视频文件，再由前端 <video></video> 标签播放该已加水印的文件。
为什么不能用纯 PHP 函数加水印
PHP 没有内置视频解码/编码能力，getimagesize()、imagecopy() 等图像函数只处理单帧，无法操作视频时间轴、编解码、关键帧对齐或音频同步。试图用 PHP 逐帧读取 + GD 处理 + 重新封装，性能极差且极易失败（缺少 PTS/DTS 控制、无硬件加速、不支持 H.265/AV1 等现代编码）。
用 ffmpeg 命令行叠加文字或图片水印（推荐方案）
这是最稳定、可控、高性能的方式。PHP 仅负责拼接并执行 shell 命令，核心逻辑由 ffmpeg 完成。
-
ffmpeg必须已安装并加入系统 PATH，可通过exec('ffmpeg -version', $out, $ret)验证 - 文字水印常用
drawtextfilter，注意字体文件路径需绝对且 Web 进程有读取权限 - 图片水印用
overlay，推荐 PNG（带 alpha），位置可用x=10:y=10或相对表达式如x=W-w-10:y=H-h-10 - 务必添加
-y参数自动覆盖输出，避免交互阻塞；加上-v quiet减少日志干扰
ffmpeg -i input.mp4 -vf "drawtext=fontfile=/var/www/font.ttf:fontsize=24:fontcolor=white:x=10:y=10:text='© MySite'" -c:a copy output_watermarked.mp4
ffmpeg -i input.mp4 -i logo.png -filter_complex "overlay=x=W-w-10:y=H-h-10" -c:a copy output_watermarked.mp4
PHP 执行时的关键安全与稳定性控制
直接 exec() 存在严重风险，必须严格过滤输入、限制资源、捕获错误。
立即学习“PHP免费学习笔记（深入）”；
- 视频路径必须用
realpath()+is_file()校验，禁止用户传入../或任意路径 - 水印文字内容需
escapeshellarg()处理，防止命令注入（例如单引号闭合） - 设置超时：
exec("timeout 300 ffmpeg ...", $output, $return_code)（Linux），Windows 可用start /b cmd /c "ffmpeg ... & exit"配合pcntl_alarm - 检查
$return_code !== 0并记录$output，常见失败原因：字体缺失、分辨率不匹配、codec 不支持、磁盘满
水印位置计算、透明度控制、多水印叠加、动态时间戳等进阶需求，都依赖 ffmpeg filter 的复杂表达式，而不是 PHP 逻辑。别试图在 PHP 层“模拟”视频处理流程——那只会掩盖底层不可靠性。
