PHP 本身不生成 MP4，真正由 FFmpeg 完成转码与尺寸调整；需确保服务器安装 FFmpeg 并配置 PHP 权限，用 -vf scale 设置分辨率，注意路径、错误捕获及滤镜语法正确性。
PHP 本身不生成 MP4，真正干活的是 FFmpeg
PHP 没有内置视频编码能力，所谓“PHP 转 MP4”实际是 PHP 调用外部命令行工具 ffmpeg 完成转码和尺寸调整。直接在 PHP 中操作二进制视频流或调用 GD/Imagick 是无效的——它们只处理图像帧，不生成合规 MP4 容器和编码流。
关键点：你必须确保服务器已安装 ffmpeg，且 PHP 进程有权限执行它（常见于 CLI 模式；Web 环境需检查 disable_functions 是否禁用了 exec、shell_exec 等）。
用 -vf scale 设置分辨率，不是靠 PHP 函数
调整输出 MP4 尺寸的核心参数是 ffmpeg 的 -vf scale 视频滤镜。PHP 只负责拼接并执行这条命令，不参与像素计算。
-
scale=1280:720：强制设为 1280×720（可能拉伸变形） -
scale=1280:-2：宽度设为 1280，高度按原始宽高比自动计算（-2 表示保持偶数，适配 H.264 编码要求） -
scale=-2:720：高度设为 720，宽度自适应 -
scale=trunc(iw/2)*2:trunc(ih/2)*2：确保宽高均为偶数（很多编码器强制要求）
务必加 -aspect 16:9（如需）配合 -vf，否则播放器可能误判显示宽高比。
立即学习“PHP免费学习笔记（深入）”；
PHP 执行时注意路径、权限与错误捕获
直接用 exec() 调用 ffmpeg 极易静默失败。常见陷阱：
- 输入路径含空格或中文：必须用单引号包裹，如
'/path/to/源视频.mp4' - 输出目录不存在或无写权限：PHP 不报错，但生成文件失败
- 未捕获 stderr：用
2>&1合并错误流，否则看不到Invalid argument或Unknown encoder 'libx264'这类关键提示 - 超时：大视频转码可能耗时数十秒，需调大
set_time_limit(0)和max_execution_time
exec("ffmpeg -i '/var/www/input.mp4' -vf 'scale=1280:-2' -c:v libx264 -c:a aac '/var/www/output.mp4' 2>&1", $output, $return_code);
if ($return_code !== 0) {
error_log("FFmpeg failed: " . implode("\n", $output));
}
避免黑边、裁剪或模糊：选对缩放策略
单纯 scale 会拉伸或压缩画面。若需保持原始比例并填充背景（如上传头像生成横版预告片），得组合滤镜：
- 加黑边（letterbox）：
-vf 'scale=1280:720:force_original_aspect_ratio=decrease,pad=1280:720:(ow-iw)/2:(oh-ih)/2' - 居中裁剪（crop）：
-vf 'scale=1280:720:force_original_aspect_ratio=increase,crop=1280:720' - 模糊背景（需 v3.4+）：
-vf 'scale=1280:720:force_original_aspect_ratio=decrease,boxblur=2:1,pad=1280:720:(ow-iw)/2:(oh-ih)/2'
这些滤镜字符串必须完整传给 -vf，中间不能换行或漏引号。FFmpeg 对语法极其敏感，一个冒号错位就报 Unable to parse option value。
真正难的不是写 PHP，而是写出正确、安全、可维护的 ffmpeg 命令；参数顺序、引号嵌套、编码器兼容性，任何一个环节出问题，输出就是损坏文件或无声黑屏。
