本文详解如何在 php 中调用 ffmpeg，在视频转码（如 mp4）过程中无缝叠加公司 logo 或水印，涵盖命令构造、尺寸适配、位置控制及安全执行要点。
本文详解如何在 php 中调用 ffmpeg，在视频转码（如 mp4）过程中无缝叠加公司 logo 或水印，涵盖命令构造、尺寸适配、位置控制及安全执行要点。
在使用 FFmpeg 进行视频格式转换（如将原始视频转为 H.264/AAC 编码的 MP4）时，叠加品牌 Logo 或水印是提升内容专业性与版权保护的关键步骤。核心在于利用 FFmpeg 的 -filter_complex 配合 overlay 滤镜实现图层合成，而非简单拼接。以下提供一套生产就绪的集成方案。
✅ 基础原理：双输入 + 复杂滤镜链
FFmpeg 支持多输入流处理。我们将视频作为主输入（索引 [0:v]），Logo 图片作为第二输入（索引 [1:v]），通过 overlay 滤镜将其叠加到指定坐标（如右下角、左上角或居中）。为确保兼容性与清晰度，推荐对 Logo 进行动态缩放适配：
ffmpeg -i "input.mp4" -i "logo-whiteb.png" \
-filter_complex "[1:v]scale=w=180:h=-1:force_original_aspect_ratio=decrease[logo]; \
[0:v][logo]overlay=x=W-w-20:y=H-h-20:format=yuv420[out]" \
-map "[out]" -map 0:a \
-c:v libx264 -c:a libfdk_aac -y "output.mp4"- scale=w=180:h=-1:force_original_aspect_ratio=decrease：将 Logo 宽度固定为 180px，高度按原比例缩放，避免拉伸；
- overlay=x=W-w-20:y=H-h-20：右下角留白 20px 安全边距（W/H 表示视频宽高，w/h 表示 Logo 宽高）；
- format=yuv420：强制输出 YUV420 色彩空间，保障播放兼容性（尤其移动端）；
- -map "[out]" -map 0:a：仅映射处理后的视频流和原始音频流，避免多余流干扰。
✅ PHP 集成：安全执行与错误处理
直接拼接字符串调用 exec() 存在注入风险。务必对文件路径进行严格校验与转义，并捕获完整错误日志：
<?php
$uploads_dir = 'original/';
$output_dir = 'converted/';
$file_name = basename($_FILES['file']['name']);
$output_name = pathinfo($file_name, PATHINFO_FILENAME);
$uploaded_file = $uploads_dir . $file_name;
$logo_path = 'https://propeview.com/wp-content/uploads/2021/08/logo-whiteb.png'; // ⚠️ 注意：需先下载至本地！
$local_logo = 'assets/logo-watermark.png';
// 1. 下载远程 Logo（仅首次或定期更新）
if (!file_exists($local_logo)) {
file_put_contents($local_logo, file_get_contents($logo_path));
}
// 2. 安全校验路径（防止 ../ 注入）
if (!preg_match('/^[a-zA-Z0-9._-]+$/', $file_name)) {
die('Invalid filename');
}
// 3. 构建 FFmpeg 命令（使用 escapeshellarg 防注入）
$ffmpeg = '/usr/bin/ffmpeg';
$input = escapeshellarg($uploaded_file);
$logo = escapeshellarg($local_logo);
$output = escapeshellarg($output_dir . $output_name . '.mp4');
$cmd = "$ffmpeg -i $input -i $logo " .
"-filter_complex \"[1:v]scale=w=180:h=-1:force_original_aspect_ratio=decrease[logo];" .
"[0:v][logo]overlay=x=W-w-20:y=H-h-20:format=yuv420[out]\" " .
"-map \"[out]\" -map 0:a " .
"-c:v libx264 -c:a libfdk_aac -y $output 2>&1";
// 4. 执行并记录日志
exec($cmd, $output_lines, $return_code);
if ($return_code !== 0) {
error_log("FFmpeg failed: " . implode("\n", $output_lines));
echo "Conversion failed. Check logs.";
} else {
echo "Success! Watermarked video saved to: {$output_dir}{$output_name}.mp4";
}
?>⚠️ 关键注意事项
- Logo 必须本地化：FFmpeg 不支持直接从 HTTP URL 加载 overlay 图片，需预先下载保存为本地文件；
-
分辨率预分析（进阶）：对于不同源视频尺寸，可先用 ffprobe 获取宽高，动态计算 overlay 坐标：
ffprobe -v quiet -show_entries stream=width,height -of csv=p=0:s=x "input.mp4"
- 性能优化：若批量处理，建议启用硬件加速（如 -hwaccel cuda）并限制线程数（-threads 2）；
- 版权合规：确保 Logo 使用符合授权协议，水印透明度建议设为 alpha=0.8（需 PNG 支持 alpha 通道）；
- 替代方案：如需更灵活控制（如文字水印、动态时间戳），可使用 drawtext 滤镜替代 overlay。
通过以上方法，你不仅能稳定地为每个转码视频嵌入品牌标识，还能构建可扩展、可维护的媒体处理流水线。记住：安全转义、日志追踪、本地资源管理，是线上环境可靠运行的三大基石。
立即学习“PHP免费学习笔记（深入）”；
