ThinkPHP6.x 视频处理：FFmpeg集成实现视频转码与截图功能-ThinkPHP-PHP中文网

若thinkphp6.x中视频转码或截图失败，需检查ffmpeg集成：一、用系统命令行调用，确认安装、权限及参数顺序（-ss须在-i前）；二、集成php-ffmpeg库，配置路径并确保文件已保存至可读位置；三、优化参数，如关键帧对齐、清晰度设置、硬件加速及错误处理。

thinkphp6.x 视频处理：ffmpeg集成实现视频转码与截图功能

如果您在ThinkPHP6.x项目中需对上传视频执行转码或截图操作，但无法生成目标格式文件或封面图，则很可能是FFmpeg未正确集成或调用方式存在缺陷。以下是解决此问题的步骤：

一、通过系统命令行直接调用FFmpeg

该方法绕过任何PHP扩展依赖，仅需确保PHP进程具备exec权限及服务器已安装FFmpeg，适用于快速验证环境可用性与最小化调试路径。

1、确认FFmpeg已安装并可被PHP访问：在终端执行which ffmpeg，返回有效路径（如/usr/bin/ffmpeg）；若无输出，需先安装FFmpeg并加入PATH。

2、检查PHP是否禁用执行函数：查看phpinfo()中disable_functions列表，确保exec、shell_exec未被禁用。

3、在控制器中构造转码命令：使用绝对路径调用ffmpeg，例如/usr/bin/ffmpeg -i /var/www/html/runtime/upload/test.mp4 -c:v libx264 -c:a aac -f mp4 /var/www/html/public/static/video/output.mp4。

4、执行并捕获结果：调用exec($cmd, $output, $returnCode)，严格校验$returnCode === 0且输出目录下存在非空目标文件。

5、截图命令必须将-ss参数置于-i之前，例如/usr/bin/ffmpeg -ss 00:00:01 -i /var/www/html/runtime/upload/test.mp4 -vframes 1 -q:v 2 /var/www/html/public/static/thumb/test.jpg，否则大视频将严重卡顿或失败。

二、集成php-ffmpeg库封装操作类

该方法提供面向对象接口，自动管理进程、超时与错误上下文，适合中大型项目长期维护，避免裸命令拼接风险。

1、使用Composer安装扩展：composer require php-ffmpeg/php-ffmpeg，版本兼容ThinkPHP6.x。

2、创建配置文件app/extra/ffmpeg.php，明确指定二进制路径：'ffmpeg.binaries' => '/usr/bin/ffmpeg', 'ffprobe.binaries' => '/usr/bin/ffprobe'，Linux与Windows路径不可混用。

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

3、在业务逻辑中初始化FFMpeg实例：$ffmpeg = FFMpeg\FFMpeg::create(config('ffmpeg'));，传入完整配置数组而非空参数。

4、打开视频文件前，确保临时上传文件已通过$file->moveTo()保存至可读路径，不能直接传入$_FILES临时路径，否则FFmpeg报“no such file”。

5、截图调用示例：$video = $ffmpeg->open('/path/to/stored/video.mp4'); $video->frame(FFMpeg\Coordinate\TimeCode::fromSeconds(1))->save('/path/to/thumb.jpg');，时间点建议避开黑场，可设为3秒。