用PHP-FFmpeg实现视频文件处理与剪辑【代码实操】-php教程-PHP中文网

根本原因是系统未安装ffmpeg命令行工具，php-ffmpeg仅是封装器，需先通过apt install ffmpeg或brew install ffmpeg等安装二进制程序，并在php中用绝对路径显式指定ffmpeg.binaries和ffprobe.binaries。

用php-ffmpeg实现视频文件处理与剪辑【代码实操】

根本原因不是PHP扩展没装，而是系统里压根没装ffmpeg命令行工具。PHP-FFmpeg只是个封装器，它依赖外部二进制程序运行。

先在终端执行 ffmpeg -version，如果提示 command not found，说明系统级 ffmpeg 没装，装了再配 PHP 才有意义
Linux/macOS 推荐用包管理器安装：apt install ffmpeg（Ubuntu/Debian）或 brew install ffmpeg（macOS）
Windows 用户需下载官方静态编译版，解压后把 ffmpeg.exe 所在目录加到系统 PATH 环境变量中

确认路径正确后，在 PHP 中显式指定二进制位置更稳妥：

$ffmpeg = FFMpeg::create([
    'ffmpeg.binaries'  => '/usr/local/bin/ffmpeg',
    'ffprobe.binaries' => '/usr/local/bin/ffprobe',
]);

这个错误常被误认为是权限问题，其实更多是路径解析失败——PHP-FFmpeg 的 open() 方法只接受绝对路径，不支持相对路径或 URL。

复古电影胶片元素合集矢量素材适用于影视制作公司宣传手册排版、视频剪辑APP工具栏UI界面悬浮图标设计、电影解说类自媒体公众号推文配图、怀旧主题影院展板、影视专业毕业设计海报及Vlog视频后期包装素材等相关视觉场景设计，由AI生成的Ai格式素材。

下载

别传 './videos/input.mp4' 或 'videos/input.mp4'，必须用 __DIR__ . '/videos/input.mp4' 或 realpath('videos/input.mp4')
检查文件是否真存在：file_exists($path) 和 is_readable($path) 建议在 open() 前手动验证
注意 Web 服务器用户（如 www-data）对文件的读取权限，尤其在 Docker 或 Nginx + PHP-FPM 场景下，宿主机 chmod 755 不一定够，可能需要 chown 到对应用户
临时文件目录也要可写：set_temporary_directory('/tmp/ffmpeg')，否则裁剪、转码中间过程会失败

PHP-FFmpeg 的 clip() 是基于关键帧（I-frame）硬切的，不是逐帧精度操作。跳过非关键帧会导致音画不同步、开头黑屏或结尾截断。

剪辑起点尽量落在关键帧上，可用 ffprobe 先查：ffprobe -v quiet -show_entries format=duration -of default=nw=1 input.mp4 查总时长，再用 -show_frames -select_streams v:0 找 I-frame 时间戳

更实用的做法是加 ->synchronize() 强制音视频对齐：

$video->filters()->clip(FFMpeg\Coordinate\TimeCode::fromSeconds(10), FFMpeg\Coordinate\TimeCode::fromSeconds(20))
    ->synchronize();

如果必须精确到帧，不要用 clip()，改用 filters()->custom() 直接传 FFmpeg 参数：
```
->filters()->custom('-ss 10.123 -t 9.877 -copyts')
```
（注意：-ss 放前面比放后面快，但精度略低；放后面更准但慢）

常见于未显式调用 save()，或保存路径不可写，或编码参数不兼容目标容器。

必须调用 save()，且参数是**绝对路径**：$video->save(new FFMpeg\Format\Video\X264(), '/var/www/output.mp4');

X264 格式默认不带音频编码器，若源视频有声音，需手动指定：

$format = new FFMpeg\Format\Video\X264('libx264', 'libmp3lame');
$format->setAudioBitrate(128);
$video->save($format, $outputPath);

MP4 容器不支持某些编码组合（如 VP9 + MP4），优先用 X264 或 X265；若要 H.265，确保 ffmpeg 编译时含 libx265
大文件导出容易超时，记得调整：ini_set('max_execution_time', 300);，并考虑用 CLI 模式而非 Web 请求执行