PHP无法直接裁剪视频黑边，但可通过调用ffmpeg的cropdetect滤镜自动检测黑边参数，再用crop滤镜执行裁剪，并建议添加scale滤镜确保尺寸为偶数及-c:a copy实现音频流快速复制。
PHP 本身不能直接裁剪视频黑边，但可以通过调用 ffmpeg 命令行工具，结合其 cropdetect 和 crop 滤镜实现自动检测并裁剪黑边（即上下/左右的纯色或近似纯色边框）。关键在于：先让 ffmpeg 分析几秒视频，输出推荐裁剪参数，再用该参数执行实际裁剪。
1. 确保系统已安装并可调用 ffmpeg
PHP 需通过 exec()、shell_exec() 等函数调用系统命令，所以：
- 确认服务器已安装 ffmpeg（运行
ffmpeg -version可查） - PHP 进程有执行外部命令权限（部分共享主机禁用，需联系服务商或换环境）
- 确保 PHP 的
disable_functions中未禁用exec、shell_exec等函数
2. 用 cropdetect 自动分析黑边尺寸
ffmpeg 的 cropdetect 滤镜会扫描视频前若干帧，输出推荐的 crop=w:h:x:y 参数。常用做法是分析前 5–10 秒，取最保守（最大）裁剪区域：
示例命令（在 PHP 中用 shell_exec 调用）：
立即学习“PHP免费学习笔记（深入）”；
ffmpeg -i input.mp4 -t 5 -vf cropdetect=24:16:0 -f null - 2>&1
说明：
-
-t 5：只分析前 5 秒，加快速度 -
cropdetect=24:16:0：阈值设为 24（越小越敏感），限制最小宽高为 16 像素，不跳过纯黑帧 -
-f null -表示不生成输出文件，只做分析 -
2>&1把错误输出（含 cropdetect 日志）合并到标准输出，PHP 才能捕获
PHP 中提取结果（简单正则匹配最后一组有效 crop 参数）：
$output = shell_exec('ffmpeg -i "input.mp4" -t 5 -vf cropdetect=24:16:0 -f null - 2>&1');
preg_match_all('/crop=([0-9]+):([0-9]+):([0-9]+):([0-9]+)/', $output, $matches);
if (!empty($matches[0])) {
$last = end($matches[0]);
preg_match('/crop=([0-9]+):([0-9]+):([0-9]+):([0-9]+)/', $last, $crop);
list(, $w, $h, $x, $y) = $crop;
}3. 执行实际裁剪（带缩放兼容性处理）
拿到 $w,$h,$x,$y 后，调用 ffmpeg 进行裁剪。注意：若原始分辨率非 16:9 或存在奇数像素，建议加 scale=trunc(iw/2)*2:trunc(ih/2)*2 保证尺寸为偶数（避免编码报错）：
ffmpeg -i input.mp4 -vf "crop={$w}:{$h}:{$x}:{$y},scale=trunc(iw/2)*2:trunc(ih/2)*2" -c:a copy output.mp4说明：
-
-c:a copy表示音频直接复制，不重编码，节省时间 - 如果视频需要重新编码（如裁剪后编码器不兼容），可去掉
-c:a copy或改用-c:v libx264 -c:a aac - 生产环境建议加
-y跳过确认，加-v quiet减少日志输出
4. 实用建议与注意事项
- 黑边不明显时（如灰边、渐变边），
cropdetect可能失效，可尝试降低阈值（如cropdetect=12）或手动指定范围 - 对高清长视频，分析时间可缩短（如
-t 2），但可能漏检；可多帧采样（配合select滤镜）提升鲁棒性 - PHP 执行超时？设置
set_time_limit(300)，或转为后台队列（如写入脚本 + cron / supervisor） - 安全第一：输入文件路径必须过滤（
realpath()+ 白名单目录校验），严禁用户直传命令参数
