PHP通过调用FFmpeg实现视频马赛克,核心是用boxblur等滤镜对指定区域模糊处理;需确保FFmpeg可用、PHP开启exec函数,并用escapeshellarg()防护命令注入,支持静态区域、时间段控制及异步队列优化。

PHP 本身不能直接处理视频,但可以通过调用系统命令(如 ffmpeg)来实现给视频加马赛克遮罩。核心思路是:用 FFmpeg 的 boxblur 或 minterpolate+scale+overlay 等滤镜,在指定时间、区域对画面做模糊/像素化处理,模拟马赛克效果。
1. 确保环境支持 FFmpeg
PHP 需要能执行 shell 命令,且服务器已安装 FFmpeg 并加入系统 PATH:
- Linux/macOS:终端运行
ffmpeg -version确认可用 - Windows:确保 ffmpeg.exe 路径已添加到环境变量,或在 PHP 中写绝对路径(如
C:\ffmpeg\bin\ffmpeg.exe) - PHP 开启
exec、shell_exec等函数(部分共享主机禁用,需自行部署或换 VPS)
2. 基础马赛克命令(固定区域+全程)
以下命令对视频中 坐标 (100,80) 开始、宽 200 高 120 的矩形区域打马赛克(使用 boxblur 模拟):
ffmpeg -i input.mp4 -vf "crop=200:120:100:80,boxblur=10,setsar=1,fps=30, scale=200:120, pad=200:120:0:0, overlay=100:80" -c:a copy output.mp4
说明:
-
crop截出目标区域 -
boxblur=10模糊强度(值越大越“糊”,类似马赛克感) -
scale和pad保证尺寸对齐,避免 overlay 报错 -
overlay=100:80将处理后的图层贴回原位置
⚠️ 注意:此方式适合静态区域;若需动态跟踪(如人脸),需先用 Python/OpenCV 提取坐标,再生成动态 overlay 命令。
3. PHP 中安全调用示例
使用 escapeshellarg() 防止路径含空格或特殊字符导致命令失败:
使用官方Model Context Protocol PHP SDK将PHP应用程序功能暴露为MCP工具、资源和提示,用于代理工作流。
$input = '/path/to/input.mp4';
$output = '/path/to/output.mp4';
$cmd = sprintf(
'ffmpeg -i %s -vf "crop=200:120:100:80,boxblur=12,setsar=1,fps=30,scale=200:120,pad=200:120:0:0,overlay=100:80" -c:a copy %s 2>&1',
escapeshellarg($input),
escapeshellarg($output)
);
$output_log = shell_exec($cmd);
if (strpos($output_log, 'error') !== false || !file_exists($output)) {
echo "处理失败:" . htmlspecialchars($output_log);
} else {
echo "完成,输出:" . htmlspecialchars($output);
}
建议补充:
- 设置超时:
set_time_limit(300)(5分钟) - 记录日志便于调试(把
$output_log写入文件) - 检查输入文件是否存在、是否为合法视频格式
4. 进阶:按时间段打马赛克
例如只在第 10–15 秒、第 30–35 秒加马赛克,可用 enable='between(t,10,15)+between(t,30,35)' 控制滤镜启用时机:
-vf "crop=200:120:100:80,boxblur=12,setsar=1,fps=30,scale=200:120,pad=200:120:0:0,overlay=100:80:enable='between(t,10,15)+between(t,30,35)'"
这样其他时段该区域保持原样,更灵活实用。
不复杂但容易忽略权限、路径、错误捕获这些细节。实际项目中建议封装成独立脚本,配合队列异步处理大视频。
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!










