根本原因是ffmpeg二进制缺失或libx264编码器不支持；需验证ffmpeg -version及ffmpeg -encoders | grep x264，确保安装带x264支持的版本，并启用-movflags +faststart、H.264+AAC编码。
PHP-FFMpeg 无法生成 MP4 文件，常见原因是什么？
根本问题往往不是库本身，而是底层 ffmpeg 命令缺失或编码器不支持。PHP-FFMpeg 只是封装，真正干活的是系统里安装的 ffmpeg 二进制程序。如果执行失败但没报错，大概率是 ffmpeg 没装、版本太老，或缺少 libx264 编码器（MP4 必需）。
验证方式很简单：
ffmpeg -version
再检查是否支持 H.264：
ffmpeg -encoders | grep x264
如果没输出，就得重装带 x264 支持的 ffmpeg（Ubuntu 推荐用 apt install ffmpeg 而非 snap 版；macOS 用 brew install ffmpeg --with-x264）。
立即学习“PHP免费学习笔记（深入）”；
压缩时指定分辨率和码率，clip->rescale() 和 clip->filters()->resize() 有什么区别？
两者都改尺寸，但行为不同：rescale() 是 FFMpeg\Media\Video 方法，直接调用 ffmpeg 的 -vf scale=...；而 resize() 属于滤镜链，更灵活，支持保持宽高比、填充黑边等。
实际选哪个，看需求：
-
rescale(640, 480)：硬性拉伸到 640×480，可能变形 -
filters()->resize(640, 480, \FFMpeg\Filters\Video\ResizeFilter::RESIZEMODE_FIT)：等比缩放后居中，多余区域填黑边（推荐用于统一输出尺寸） - 若只压缩不改尺寸，优先用
setKiloBitrate(1000)控制码率，比单纯调分辨率更影响体积
导出 MP4 失败并报错 “Unable to write to file”，怎么排查？
这个错误表面是权限问题，但真实原因常被忽略：
- 目标目录不存在，且 PHP 进程无权创建（
mkdir()不会自动递归创建父级） - 临时文件路径（如
/tmp）磁盘满或 inodes 耗尽（df -i查） - PHP 的
open_basedir限制了写入路径（尤其在共享主机上） - FFmpeg 输出时用了相对路径，而当前工作目录（
getcwd()）不可写
稳妥做法是显式指定绝对路径，并提前确认可写：
$video->save(new \FFMpeg\Format\Video\X264(), '/var/www/output/video.mp4');
同时确保该路径所在分区有足够空间，且 www-data（或对应用户）对该目录有 w 权限。
为什么生成的 MP4 在 Safari 或 iOS 上无法播放？
核心原因是未启用 movflags=+faststart —— 它把 moov box 移到文件开头，否则浏览器得下载完整文件才能开始播放。PHP-FFMpeg 默认不加这个参数。
解决方法是在格式对象里手动注入：
$format = new \FFMpeg\Format\Video\X264();<br>$format->setAdditionalParameters(['-movflags', '+faststart']);<br>$video->save($format, 'output.mp4');
注意：faststart 会略微增加转码时间（因为要二次扫描），但对用户体验至关重要。别跳过这步，尤其面向移动端。
另外，音频编码必须是 AAC（libfaac 已废弃，用 libfdk_aac 或默认 aac），H.264 + AAC + faststart，三者缺一不可。
