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

PHP-FFmpeg安装后执行FFMpeg::create()报错“Unable to load 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', ]);
用open()打开视频时提示“File does not exist or is not readable”
这个错误常被误认为是权限问题,其实更多是路径解析失败——PHP-FFmpeg 的 open() 方法只接受绝对路径,不支持相对路径或 URL。
- 别传
'./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'),否则裁剪、转码中间过程会失败
调用clip()剪辑时输出视频无声或时长不对
PHP-FFmpeg 的 clip() 是基于关键帧(I-frame)硬切的,不是逐帧精度操作。跳过非关键帧会导致音画不同步、开头黑屏或结尾截断。
复古电影胶片元素合集矢量素材适用于影视制作公司宣传手册排版、视频剪辑APP工具栏UI界面悬浮图标设计、电影解说类自媒体公众号推文配图、怀旧主题影院展板、影视专业毕业设计海报及Vlog视频后期包装素材等相关视觉场景设计,由AI生成的Ai格式素材。
- 剪辑起点尽量落在关键帧上,可用 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 放前面比放后面快,但精度略低;放后面更准但慢)
导出 MP4 时提示“Unable to write to file”或生成 0 字节文件
常见于未显式调用 save(),或保存路径不可写,或编码参数不兼容目标容器。
立即学习“PHP免费学习笔记(深入)”;
- 必须调用
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 请求执行


















