本文详解如何在 php 调用 ffmpeg 转换视频为 mp4 的同时，精准叠加公司 logo（如 png 透明图）作为水印，涵盖命令构造、坐标定位、缩放适配及安全执行要点。
本文详解如何在 php 调用 ffmpeg 转换视频为 mp4 的同时，精准叠加公司 logo（如 png 透明图）作为水印，涵盖命令构造、坐标定位、缩放适配及安全执行要点。
在视频处理自动化流程中，为输出视频嵌入品牌 Logo 是常见需求。FFmpeg 提供强大的 overlay 滤镜支持透明 PNG 水印叠加，而 PHP 可通过 exec() 安全调用完成集成。关键在于：正确组织输入流索引、合理缩放 Logo 尺寸、指定 YUV 格式兼容性，并保留原始音频流。
以下是一个完整、健壮的实现方案：
✅ 推荐命令（带自适应缩放与位置控制）
ffmpeg -i "input.mp4" -i "logo-whiteb.png" \
-filter_complex \
"[1:v]scale=w=200:h=-1:force_original_aspect_ratio=decrease, \
pad=w=200:h=200:x=(200-iw)/2:y=(200-ih)/2:color=black@0[logo]; \
[0:v][logo]overlay=x=20:y=20:format=yuv420[out]" \
-map "[out]" -map 0:a -c:a copy -c:v libx264 -y "output.mp4"? 说明：
- [1:v] 表示第二个输入（即 logo.png）的视频流；[0:v] 是主视频；
- scale=w=200:h=-1:force_original_aspect_ratio=decrease 将 Logo 等比缩放到宽度 200px（高度自动计算），避免拉伸；
- pad 添加透明/黑色背景确保尺寸规整（可选，提升兼容性）；
- overlay=x=20:y=20 将 Logo 放置在距左上角 (20, 20) 像素处；支持 x='w-w/4':y='h-h/4' 实现右下角定位；
- format=yuv420 是关键参数——强制使用广泛兼容的像素格式，避免播放器解码失败；
- -map 0:a -c:a copy 直接复制原始音频流，不重新编码，提升速度并保质；
- -y 自动覆盖输出文件，避免交互阻塞。
✅ 集成到 PHP 的安全写法（含错误检查与路径防护）
<?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-whiteb.png';
// 1. 下载远程 Logo（仅首次或定期更新时执行，避免每次请求）
if (!file_exists($local_logo)) {
file_put_contents($local_logo, file_get_contents($logo_path));
}
// 2. 验证输入文件与 FFmpeg 路径
if (!is_uploaded_file($_FILES['file']['tmp_name']) || !file_exists($uploaded_file)) {
die('Invalid upload.');
}
$ffmpeg = '/usr/bin/ffmpeg'; // ✅ 使用绝对路径，运行前执行 `which ffmpeg` 确认
if (!is_executable($ffmpeg)) {
die('FFmpeg not found or not executable.');
}
// 3. 构建安全命令（防 shell 注入：escapeshellarg）
$cmd = sprintf(
'%s -i %s -i %s -filter_complex "[1:v]scale=w=200:h=-1:force_original_aspect_ratio=decrease[logo]; [0:v][logo]overlay=x=20:y=20:format=yuv420[out]" -map "[out]" -map 0:a -c:a copy -c:v libx264 -y %s',
escapeshellarg($ffmpeg),
escapeshellarg($uploaded_file),
escapeshellarg($local_logo),
escapeshellarg($output_dir . $output_name . '.mp4')
);
// 4. 执行并捕获结果
exec($cmd . ' 2>&1', $output, $return_code);
if ($return_code !== 0) {
error_log("FFmpeg failed: " . implode("\n", $output));
echo "Video processing failed. Check server logs.";
} else {
echo "✅ Success! Watermarked video saved: " . htmlspecialchars($output_name . '.mp4');
}
?>⚠️ 重要注意事项
- 禁止直接使用远程 URL 作为 -i 输入：FFmpeg 不支持直接从 HTTP 加载 overlay 图片（除非编译时启用 --enable-libcurl 且配置复杂）。务必先下载 Logo 到本地磁盘。
- 始终使用 escapeshellarg()：防止恶意文件名触发命令注入（如 ; rm -rf /）。
-
避免硬编码分辨率：若视频分辨率未知，建议先用 ffprobe 获取尺寸：
ffprobe -v quiet -show_entries stream=width,height -of csv=p=0:s=x input.mp4
再动态生成 scale 和 overlay 参数。
立即学习“PHP免费学习笔记（深入）”；
- 透明 PNG 要求：确保 Logo 为带 Alpha 通道的 PNG，否则背景会显示为黑色块。
- 性能优化：对高并发场景，考虑队列化处理（如 Redis + Worker）或预生成不同尺寸 Logo 减少实时缩放开销。
通过以上方法，您即可在保持原有转码逻辑的基础上，稳定、专业地为每个输出视频注入品牌标识，兼顾视觉效果与工程健壮性。
