exec执行ffmpeg失败主因是路径与权限：需确认ffmpeg在PATH中、PHP用户有执行及读写权限、全部路径用绝对路径；php-ffmpeg须显式指定ffmpeg/ffprobe路径并调高timeout；clip参数单位为秒，frame_rate控制截图频率。
exec执行ffmpeg命令时，路径和权限最容易出问题
直接用 exec 调用 ffmpeg 看似简单，但多数失败不是语法错，而是环境没配对。常见现象是返回空字符串或 Command not found 错误。
必须确认三件事：
-
ffmpeg二进制在系统 PATH 中可访问（在终端运行which ffmpeg看输出） - PHP 进程用户（如
www-data或nginx）有权限执行该二进制和读写输入/输出目录 - 命令中所有路径（含输入文件、输出路径、临时目录）都用绝对路径，相对路径在 web 服务下极不可靠
推荐写法：
$cmd = '/usr/bin/ffmpeg -i /var/www/uploads/input.mp4 -vf "scale=640:-2" /var/www/output/resized.mp4 2>&1'; exec($cmd, $output, $return_code); if ($return_code !== 0) { error_log('FFmpeg failed: ' . implode("\n", $output)); }注意 2>&1 把错误重定向到标准输出，否则 $output 拿不到报错信息。
php-ffmpeg库的安装和初始化绕不开PATH和二进制绑定
composer install php-ffmpeg/php-ffmpeg 只是第一步。它默认仍会去 PATH 查找 ffmpeg、ffprobe，如果找不到，就会抛出 RuntimeException: FFMPEG binary not found。
立即学习“PHP免费学习笔记（深入）”；
正确初始化方式是显式指定路径：
$ffmpeg = FFMpeg\FFMpeg::create([ 'ffmpeg.binaries' => '/usr/local/bin/ffmpeg', 'ffprobe.binaries' => '/usr/local/bin/ffprobe', 'timeout' => 3600, 'ffmpeg.threads' => 12 ])
注意点：
- 两个二进制路径必须都设，哪怕只用
ffmpeg；ffprobe用于元信息解析，很多操作（如获取时长、码率）底层自动调用它 -
timeout默认 30 秒，处理大视频极易超时，务必按需调高 - 不要在循环里反复调用
FFMpeg::create()，它每次都会 fork 新进程，开销大
用php-ffmpeg裁剪视频时，start和duration参数单位是秒且支持小数
很多人以为 clip 的 start 和 duration 是帧数或毫秒，实际单位是浮点秒。比如截取从第 15.3 秒开始、持续 8.7 秒的片段：
$video = $ffmpeg->open('/path/to/input.mp4'); $clip = $video->clip(FFMpeg\Coordinate\TimeCode::fromSeconds(15.3), FFMpeg\Coordinate\TimeCode::fromSeconds(8.7)); $clip->export()->toDisk('local')->inFormat(new FFMpeg\Format\Video\X264())->save('clipped.mp4');
关键细节：
-
TimeCode::fromSeconds()是唯一可靠方式，别手动拼字符串（如'00:00:15.3'），某些版本解析不稳定 - 如果原始视频帧率低（如 12fps），小数秒可能无法精确对齐关键帧，导出后起始画面会有轻微偏移——这是 FFmpeg 本身限制，不是 PHP 层能绕过的
- 裁剪不重新编码？不行。
clip()底层仍是-ss+-t，除非加-c:v copy，但 php-ffmpeg 默认不启用流复制，必须自定义格式类或改用addFilter
生成缩略图时，frame_rate影响数量和性能
用 frame_rate 控制截图频率比循环调用 getFrameFromSeconds() 更高效，也更可控。例如每 5 秒截一张：
$video->filters()->resize(new FFMpeg\Coordinate\Dimension(320, 240)) ->synchronize(); $video->frame(FFMpeg\Coordinate\TimeCode::fromSeconds(0))->save('thumb_00.jpg'); $video->frame(FFMpeg\Coordinate\TimeCode::fromSeconds(5))->save('thumb_05.jpg');
但更通用的做法是用 frame_rate 参数配合 exportFramesToDisk：
- 设
frame_rate => 1/5表示每 5 秒一帧（不是每秒 1/5 帧） - 输出目录必须已存在且可写，库不会自动创建父目录
- 大量截图时，
frame_rate => 1（每秒一帧）可能产生数百个文件，建议加setLimit(10)控制总数 - 缩略图质量由输出格式决定：用
WebP格式比JPEG小 30%+，但需确保 GD 或 Imagick 支持 WebP 编码
真正麻烦的是时间戳精度——FFmpeg 实际截图时刻可能比指定时间略晚（因关键帧对齐），所以别指望 frame_rate => 1/3 严格等于每 3 秒整点截图。
