alaloul / php-ffmpeg
FFMpeg PHP,一个用于与AVconv / ffmpeg通信的面向对象的库
Requires
- php: ^5.3.9 || ^7.0
- alchemy/binary-driver: ^1.5
- doctrine/cache: ^1.0
- evenement/evenement: ^2.0 || ^1.0
- neutron/temporary-filesystem: ^2.1.1
Requires (Dev)
- phpunit/phpunit: ^4.8.36
- sami/sami: ~1.0
- silex/silex: ~1.0
Suggests
- php-ffmpeg/extras: A compilation of common audio & video drivers for PHP-FFMpeg
- v1.x-dev
- v0.12
- v0.11.1-pl-1
- v0.11.1
- v0.11.0
- v0.10.0
- 0.9.5
- 0.9.4
- 0.9.3
- 0.9.2
- 0.9.1
- 0.9.0
- 0.8.0
- dev-master / 0.7.x-dev
- 0.7.0
- 0.6.1
- 0.6.0
- 0.5.1
- 0.5.0
- 0.4.x-dev
- 0.4.5
- 0.4.4
- 0.4.3
- 0.4.2
- 0.4.1
- 0.4.0
- 0.3.x-dev
- 0.3.5
- 0.3.4
- 0.3.3
- 0.3.2
- 0.3.1
- 0.3.0
- 0.2.4
- 0.2.3
- 0.2.2
- 0.2.1
- 0.2.0
- v0.1.x-dev
- 0.1.1
- 0.1.0
- dev-revert-344-jens1o-feature-audio-params
- dev-hhvm
This package is not auto-updated.
Last update: 2024-09-19 19:14:33 UTC
README
一个用于使用FFmpeg / AVConv转换视频/音频文件的面向对象库。
请注意:请查看另一个令人惊叹的仓库:PHP FFMpeg extras,在那里您可以找到大量的音频/视频格式。
请注意
这个库是如何工作的
此库需要一个工作的FFmpeg安装。您需要FFmpeg和FFProbe的binaries来使用它。请确保这些binaries可以通过系统PATH定位,以利用binary检测的优势,否则您必须在加载时显式给出binaries路径。
对于Windows用户:请在http://ffmpeg.zeranoe.com/builds/找到binaries。
已知问题
- 当使用libav 0.8时,使用旋转和缩放会产生损坏的输出。该错误在版本9中已修复。此错误在最新的ffmpeg版本中不会出现。
安装
安装PHP-FFMpeg的推荐方法是通过Composer。
$ composer require php-ffmpeg/php-ffmpeg
基本用法
require 'vendor/autoload.php'; $ffmpeg = FFMpeg\FFMpeg::create(); $video = $ffmpeg->open('video.mpg'); $video ->filters() ->resize(new FFMpeg\Coordinate\Dimension(320, 240)) ->synchronize(); $video ->frame(FFMpeg\Coordinate\TimeCode::fromSeconds(10)) ->save('frame.jpg'); $video ->save(new FFMpeg\Format\Video\X264(), 'export-x264.mp4') ->save(new FFMpeg\Format\Video\WMV(), 'export-wmv.wmv') ->save(new FFMpeg\Format\Video\WebM(), 'export-webm.webm');
文档
此文档是发现API的介绍。建议浏览源代码,因为它已经自我文档化了。
FFMpeg
FFMpeg\FFMpeg
是用于操作媒体的主要对象。要构建它,请使用静态的FFMpeg\FFMpeg::create
$ffmpeg = FFMpeg\FFMpeg::create();
FFMpeg会自动检测ffmpeg和ffprobe的binaries。如果您想显式提供binaries路径,可以传递一个配置数组。还可以传递一个Psr\Logger\LoggerInterface
来记录binary执行。
$ffmpeg = FFMpeg\FFMpeg::create(array( 'ffmpeg.binaries' => '/opt/local/ffmpeg/bin/ffmpeg', 'ffprobe.binaries' => '/opt/local/ffmpeg/bin/ffprobe', 'timeout' => 3600, // The timeout for the underlying process 'ffmpeg.threads' => 12, // The number of threads that FFMpeg should use ), $logger);
操作媒体
FFMpeg\FFMpeg
根据URI创建媒体。URI可以是本地文件系统资源的指针、HTTP资源或FFmpeg支持的任何资源。
注意:要列出您的FFmpeg构建支持的资源类型,请使用-protocols
命令
ffmpeg -protocols
要打开资源,请使用FFMpeg\FFMpeg::open
方法。
$ffmpeg->open('video.mpeg');
可以解析两种类型的媒体:FFMpeg\Media\Audio
和FFMpeg\Media\Video
。第三种类型,FFMpeg\Media\Frame
,通过视频提供。
视频
FFMpeg\Media\Video
可以转码,即:更改编解码器、隔离音频或视频。可以提取帧。
转码
您可以使用FFMpeg\Media\Video:save
方法转码视频。您将传递一个FFMpeg\Format\FormatInterface
。
请注意,音频和视频比特率在格式中设置。
$format = new FFMpeg\Format\Video\X264(); $format->on('progress', function ($video, $format, $percentage) { echo "$percentage % transcoded"; }); $format ->setKiloBitrate(1000) ->setAudioChannels(2) ->setAudioKiloBitrate(256); $video->save($format, 'video.avi');
转码进度可以实时监控,有关更多信息,请参阅下面的格式文档。
提取图像
您可以使用FFMpeg\Media\Video::frame
方法在任何时间码处提取帧。
此代码返回一个对应于第42秒的FFMpeg\Media\Frame
实例。您可以传递任何FFMpeg\Coordinate\TimeCode
作为参数,有关更多信息,请参阅下面的专用文档。
$frame = $video->frame(FFMpeg\Coordinate\TimeCode::fromSeconds(42)); $frame->save('image.jpg');
如果您想从视频中提取多个图像,可以使用以下过滤器
$video ->filters() ->extractMultipleFrames(FFMpeg\Filters\Video\ExtractMultipleFramesFilter::FRAMERATE_EVERY_10SEC, '/path/to/destination/folder/') ->synchronize(); $video ->save(new FFMpeg\Format\Video\X264(), '/path/to/new/file');
剪辑
在所需点切割视频。使用输入搜索方法。这是比使用filter clip更快的选项。
$clip = $video->clip(FFMpeg\Coordinate\TimeCode::fromSeconds(30), FFMpeg\Coordinate\TimeCode::fromSeconds(15)); $clip->save(new FFMpeg\Format\Video\X264(), 'video.avi');
剪辑过滤器接受两个参数
$start
,一个FFMpeg\Coordinate\TimeCode
的实例,指定剪辑的起点$duration
,可选,一个FFMpeg\Coordinate\TimeCode
的实例,指定剪辑的持续时间
在剪辑上,您可以应用与视频中相同的过滤器,例如调整大小过滤器。
$clip = $video->clip(FFMpeg\Coordinate\TimeCode::fromSeconds(30), FFMpeg\Coordinate\TimeCode::fromSeconds(15)); $clip->filters()->resize(new FFMpeg\Coordinate\Dimension(320, 240), FFMpeg\Filters\Video\ResizeFilter::RESIZEMODE_INSET, true); $clip->save(new FFMpeg\Format\Video\X264(), 'video.avi');
生成波形图
您可以使用FFMpeg\Media\Audio::waveform
方法生成音频文件的波形图。
此代码返回一个FFMpeg\Media\Waveform
实例。您可以可选地传递前两个参数作为尺寸,以及ffmpeg用于波形图的一组十六进制字符串颜色,有关更多信息,请参阅下面的专用文档。
输出文件必须使用PNG扩展名。
$waveform = $audio->waveform(640, 120, array('#00FF00')); $waveform->save('waveform.png');
如果您想从视频中获取波形图,首先将其转换为音频文件。
// Open your video file $video = $ffmpeg->open( 'video.mp4' ); // Set an audio format $audio_format = new FFMpeg\Format\Audio\Mp3(); // Extract the audio into a new file as mp3 $video->save($audio_format, 'audio.mp3'); // Set the audio file $audio = $ffmpeg->open( 'audio.mp3' ); // Create the waveform $waveform = $audio->waveform(); $waveform->save( 'waveform.png' );
过滤器
您可以使用FFMpeg\Media\Video::addFilter
方法在FFMpeg\Media\Video
上应用过滤器。视频接受音频和视频过滤器。
您可以构建自己的过滤器,PHP-FFMpeg中包含一些,它们可以通过FFMpeg\Media\Video::filters
方法访问。
过滤器是可链的
$video ->filters() ->resize($dimension, $mode, $useStandards) ->framerate($framerate, $gop) ->synchronize();
旋转
将视频旋转到指定角度。
$video->filters()->rotate($angle);
$angle
参数必须是以下常量之一
FFMpeg\Filters\Video\RotateFilter::ROTATE_90
:顺时针90°FFMpeg\Filters\Video\RotateFilter::ROTATE_180
:180°FFMpeg\Filters\Video\RotateFilter::ROTATE_270
:逆时针90°
调整大小
将视频调整到指定大小。
$video->filters()->resize($dimension, $mode, $useStandards);
调整大小过滤器需要三个参数
$dimension
,一个FFMpeg\Coordinate\Dimension
实例$mode
,以下常量之一FFMpeg\Filters\Video\ResizeFilter::RESIZEMODE_*
$useStandards
,一个布尔值,强制使用最接近的宽高比标准。
如果您想要非标准宽高比的视频,可以使用填充过滤器将视频调整到所需大小,并用黑色边框包裹。
$video->filters()->pad($dimension);
填充过滤器需要一个参数
$dimension
,一个FFMpeg\Coordinate\Dimension
实例
别忘了保存。
$video->save(new FFMpeg\Format\Video\X264(), $new_file);
水印
使用给定的图像给视频添加水印。
$video ->filters() ->watermark($watermarkPath, array( 'position' => 'relative', 'bottom' => 50, 'right' => 50, ));
水印过滤器需要两个参数
$watermarkPath
,水印文件的路径。$coordinates
,一个数组,定义您想将水印放置的位置。您可以像上面那样使用相对定位或绝对定位
$video ->filters() ->watermark($watermarkPath, array( 'position' => 'absolute', 'x' => 1180, 'y' => 620, ));
帧率
更改视频的帧率。
$video->filters()->framerate($framerate, $gop);
帧率过滤器需要两个参数
$framerate
,一个FFMpeg\Coordinate\Framerate
实例$gop
,一个GOP值(整数)
同步
同步音频和视频。
某些容器可能使用导致输出不同步的延迟。此过滤器解决了此问题。
$video->filters()->synchronize();
剪辑
在所需点切割视频。
$video->filters()->clip(FFMpeg\Coordinate\TimeCode::fromSeconds(30), FFMpeg\Coordinate\TimeCode::fromSeconds(15));
剪辑过滤器接受两个参数
$start
,一个FFMpeg\Coordinate\TimeCode
的实例,指定剪辑的起点$duration
,可选,一个FFMpeg\Coordinate\TimeCode
的实例,指定剪辑的持续时间
裁剪
根据宽度和高度(一个Point
)裁剪视频。
$video->filters()->crop(new FFMpeg\Coordinate\Point("t*100", 0, true), new FFMpeg\Coordinate\Dimension(200, 600));
它需要两个参数
$point
,一个FFMpeg\Coordinate\Point
实例,指定裁剪的点$dimension
,一个FFMpeg\Coordinate\Dimension
实例,指定输出视频的尺寸
音频
FFMpeg\Media\Audio
也可以进行转码,即:更改编解码器、分离音频或视频。可以提取帧。
转码
您可以使用FFMpeg\Media\Audio:save
方法进行音频转码。您将传递一个FFMpeg\Format\FormatInterface
。
请注意,音频千比特率是在音频格式中设置的。
$ffmpeg = FFMpeg\FFMpeg::create(); $audio = $ffmpeg->open('track.mp3'); $format = new FFMpeg\Format\Audio\Flac(); $format->on('progress', function ($audio, $format, $percentage) { echo "$percentage % transcoded"; }); $format ->setAudioChannels(2) ->setAudioKiloBitrate(256); $audio->save($format, 'track.flac');
转码进度可以实时监控,有关更多信息,请参阅下面的格式文档。
过滤器
您可以使用FFMpeg\Media\Audio::addFilter
方法在FFMpeg\Media\Audio
上应用过滤器。它只接受音频过滤器。
您可以构建自己的过滤器,PHP-FFMpeg中包含一些,它们可以通过FFMpeg\Media\Audio::filters
方法访问。
剪辑
在所需点切割音频。
$audio->filters()->clip(FFMpeg\Coordinate\TimeCode::fromSeconds(30), FFMpeg\Coordinate\TimeCode::fromSeconds(15));
元数据
向音频文件添加元数据。只需传递您要添加的所有元数据的键=值对数组。如果没有传递任何参数到过滤器,则将从输入文件中删除所有元数据。目前支持的数据有标题、艺术家、专辑、作曲家、曲目、年份、描述、封面
$audio->filters()->addMetadata(["title" => "Some Title", "track" => 1]); //remove all metadata and video streams from audio file $audio->filters()->addMetadata();
将艺术作品添加到音频文件
$audio->filters()->addMetadata(["artwork" => "/path/to/image/file.jpg"]);
注意:目前ffmpeg(版本3.2.2)仅支持.mp3文件的封面输出
重采样
重采样音频文件。
$audio->filters()->resample($rate);
重采样过滤器有两个参数
$rate
,有效的音频采样率值(整数)
帧
帧是视频在某个时间码处的图像;参见上面的文档关于帧提取。
您可以使用FFMpeg\Media\Frame::save
方法保存帧。
$frame->save('target.jpg');
此方法有一个可选的第二个布尔参数。将其设置为true以获取准确图像;执行时间更长。
Gif
gif是从视频序列中提取的动画图像。
您可以使用FFMpeg\Media\Gif::save
方法保存gif文件。
$video = $ffmpeg->open( '/path/to/video' ); $video ->gif(FFMpeg\Coordinate\TimeCode::fromSeconds(2), new FFMpeg\Coordinate\Dimension(640, 480), 3) ->save($new_file);
此方法有一个第三个可选的布尔参数,它是动画的持续时间。如果您不设置它,您将得到一个固定图像的gif。
连接
此功能允许您根据多个源生成一个音频或视频文件。
根据源代码的编解码器,有两种连接视频的方法。如果您的源都使用相同的编解码器编码,您将希望使用性能更好的FFMpeg\Media\Concatenate::saveFromSameCodecs
。如果您的源使用不同的编解码器编码,您将希望使用FFMpeg\Media\Concatenate::saveFromDifferentCodecs
。
第一个函数将使用初始编解码器作为生成文件的编解码器。使用第二个函数,您可以选择生成文件希望使用的编解码器。
您还需要注意,当使用saveFromDifferentCodecs方法时,您的文件必须具有视频和音频流。
在两种情况下,您都必须提供一个文件数组。
要连接使用相同编解码器编码的视频,请按照以下操作进行
// In order to instantiate the video object, you HAVE TO pass a path to a valid video file. // We recommand that you put there the path of any of the video you want to use in this concatenation. $video = $ffmpeg->open( '/path/to/video' ); $video ->concat(array('/path/to/video1', '/path/to/video2')) ->saveFromSameCodecs('/path/to/new_file', TRUE);
保存函数的布尔参数允许您使用复制参数,这可以极大地加快编码文件的生成。
要连接使用相同编解码器编码的视频,请按照以下操作进行
// In order to instantiate the video object, you HAVE TO pass a path to a valid video file. // We recommand that you put there the path of any of the video you want to use in this concatenation. $video = $ffmpeg->open( '/path/to/video' ); $format = new FFMpeg\Format\Video\X264(); $format->setAudioCodec("libmp3lame"); $video ->concat(array('/path/to/video1', '/path/to/video2')) ->saveFromDifferentCodecs($format, '/path/to/new_file');
有关FFMPEG中连接的更多详细信息,请参阅此处、此处和此处。
格式
格式实现FFMpeg\Format\FormatInterface
。要将视频保存到文件,请使用FFMpeg\Format\VideoInterface
,对于音频文件使用FFMpeg\Format\AudioInterface
。
格式还可以扩展FFMpeg\Format\ProgressableInterface
以获取实时转码信息。
预定义的格式已经提供了作为事件的事件进度信息。
$format = new FFMpeg\Format\Video\X264(); $format->on('progress', function ($video, $format, $percentage) { echo "$percentage % transcoded"; }); $video->save($format, 'video.avi');
为事件提供的事件回调可以是任何可调用的。
添加附加参数
您可以根据您的视频格式添加附加参数到您的编码请求。
setAdditionalParameters方法的参数是一个数组。
$format = new FFMpeg\Format\Video\X264(); $format->setAdditionalParameters(array('foo', 'bar')); $video->save($format, 'video.avi');
创建自己的格式
创建格式的最简单方法是扩展抽象的FFMpeg\Format\Video\DefaultVideo
和FFMpeg\Format\Audio\DefaultAudio
,并实现以下方法。
class CustomWMVFormat extends FFMpeg\Format\Video\DefaultVideo { public function __construct($audioCodec = 'wmav2', $videoCodec = 'wmv2') { $this ->setAudioCodec($audioCodec) ->setVideoCodec($videoCodec); } public function supportBFrames() { return false; } public function getAvailableAudioCodecs() { return array('wmav2'); } public function getAvailableVideoCodecs() { return array('wmv2'); } }
坐标
FFMpeg使用许多时间和空间坐标单位。
FFMpeg\Coordinate\AspectRatio
表示宽高比。FFMpeg\Coordinate\Dimension
表示维度。FFMpeg\Coordinate\FrameRate
表示帧率。FFMpeg\Coordinate\Point
表示一个点。(从v0.10.0开始支持动态点)FFMpeg\Coordinate\TimeCode
表示时间码。
FFProbe
FFMpeg\FFProbe
是FFMpeg\FFMpeg
内部使用的,用于探测媒体。您也可以使用它来提取媒体元数据。
$ffprobe = FFMpeg\FFProbe::create(); $ffprobe ->streams('/path/to/video/mp4') // extracts streams informations ->videos() // filters video streams ->first() // returns the first video stream ->get('codec_name'); // returns the codec_name property
$ffprobe = FFMpeg\FFProbe::create(); $ffprobe ->format('/path/to/video/mp4') // extracts file informations ->get('duration'); // returns the duration property
验证媒体文件
(从0.10.0开始)您可以使用PHP-FFMpeg的FFProbe包装器验证媒体文件。
$ffprobe = FFMpeg\FFProbe::create(); $ffprobe->isValid('/path/to/file/to/check'); // returns bool
与Silex微框架一起使用
服务提供者很容易设置
$app = new Silex\Application(); $app->register(new FFMpeg\FFMpegServiceProvider()); $video = $app['ffmpeg']->open('video.mpeg');
可用的选项如下
$app->register(new FFMpeg\FFMpegServiceProvider(), array( 'ffmpeg.configuration' => array( 'ffmpeg.threads' => 4, 'ffmpeg.timeout' => 300, 'ffmpeg.binaries' => '/opt/local/ffmpeg/bin/ffmpeg', 'ffprobe.timeout' => 30, 'ffprobe.binaries' => '/opt/local/ffmpeg/bin/ffprobe', ), 'ffmpeg.logger' => $logger, ));
许可协议
本项目采用MIT 许可协议进行许可。