viitech / php-ffmpeg
FFMpeg PHP,一个用于与 AVconv / ffmpeg 通信的面向对象库
Requires
- php: ^5.3.9 || ^7.0
- alchemy/binary-driver: ^1.5 || ~2.0.0 || ^5.0
- doctrine/cache: ^1.0
- evenement/evenement: ^3.0 || ^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.15
- v0.14
- v0.13
- 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-21 14:14:35 UTC
README
一个用于使用 FFmpeg / AVConv 转换视频/音频文件的面向对象库。
请注意:查看另一个惊人的仓库: PHP FFMpeg extras,在那里您可以找到许多音频/视频格式。
请注意
这个库是如何工作的
此库需要一个可工作的 FFmpeg 安装。您需要 FFmpeg 和 FFProbe 的二进制文件来使用它。请确保这些二进制文件可以通过系统 PATH 定位,以便获得二进制检测的优势,否则您必须在加载时显式提供二进制文件路径。
对于 Windows 用户:请在 http://ffmpeg.zeranoe.com/builds/ 找到二进制文件。
已知问题
- 在使用 libav 0.8 时,使用旋转和缩放将产生损坏的输出。此错误在版本 9 中已修复。此错误在最新版本的 FFmpeg 中不会出现。
安装
推荐通过 Composer 安装 PHP-FFMpeg。
$ 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 二进制文件。如果您想显式提供二进制文件路径,可以传递一个配置数组。还可以传递一个 Psr\Logger\LoggerInterface
来记录二进制执行。
$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');
默认情况下,这将保存帧为 jpg
图像。
您可以使用 setFrameFileType
来覆盖此设置,以将帧保存为其他格式
$frameFileType = 'jpg'; // either 'jpg', 'jpeg' or 'png' $filter = new ExtractMultipleFramesFilter($frameRate, $destinationFolder); $filter->setFrameFileType($frameFileType); $video->addFilter($filter);
剪辑
在所需点切割视频。使用输入查找方法。这是比使用过滤器剪辑更快的选项。
$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
的实例,指定剪辑的持续时间
裁剪
根据宽度和高度(一个点)裁剪视频。
$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 recommend 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 recommend 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中连接的更多详细信息,请参阅此处、此处和此处。
高级媒体
高级媒体可能有多个输入和多个输出。
此类主要开发用于与-filter_complex
一起使用。
因此,其filters()
方法仅接受可以在-filter_complex
命令中使用的过滤器。高级媒体已经包含了一些内置的过滤器。
基本用法
例如
$advancedMedia = $ffmpeg->openAdvanced(array('video_1.mp4', 'video_2.mp4')); $advancedMedia->filters() ->custom('[0:v][1:v]', 'hstack', '[v]'); $advancedMedia ->map(array('0:a', '[v]'), new X264('aac', 'libx264'), 'output.mp4') ->save();
此代码取2个输入视频,将它们水平堆叠成1个输出视频,并将第一个视频的音频添加到这个新视频中。(在只有一个输入和一个输出的简单filtergraph中是不可能的)。
复杂示例
高级媒体可能性的更复杂示例。假设所有输入视频已经具有相同的分辨率和持续时间。("xstack"过滤器已添加到ffmpeg的4.1版本中)。
$inputs = array( 'video_1.mp4', 'video_2.mp4', 'video_3.mp4', 'video_4.mp4', ); $advancedMedia = $ffmpeg->openAdvanced($inputs); $advancedMedia->filters() ->custom('[0:v]', 'negate', '[v0negate]') ->custom('[1:v]', 'edgedetect', '[v1edgedetect]') ->custom('[2:v]', 'hflip', '[v2hflip]') ->custom('[3:v]', 'vflip', '[v3vflip]') ->xStack('[v0negate][v1edgedetect][v2hflip][v3vflip]', XStackFilter::LAYOUT_2X2, 4, '[resultv]'); $advancedMedia ->map(array('0:a'), new Mp3(), 'video_1.mp3') ->map(array('1:a'), new Flac(), 'video_2.flac') ->map(array('2:a'), new Wav(), 'video_3.wav') ->map(array('3:a'), new Aac(), 'video_4.aac') ->map(array('[resultv]'), new X264('aac', 'libx264'), 'output.mp4') ->save();
此代码取4个输入视频,然后对第一个视频取反,将结果存储在[v0negate]
流中,检测第二个视频的边缘,将结果存储在[v1edgedetect]
流中,水平翻转第三个视频,将结果存储在[v2hflip]
流中,垂直翻转第四个视频,将结果存储在[v3vflip]
流中,然后将这4个生成的流组合成一个2x2的拼贴视频。然后保存原始视频的音频到4种不同的格式,并将生成的拼贴视频保存到单独的文件中。
如您所见,您可以在同一个ffmpeg命令中同时使用多个输入源,对它们进行复杂的处理,并生成多个输出文件。
只需给我一个映射!
您不必使用-filter_complex
。您可以使用仅-map
选项。例如,只需从视频中提取音频
$advancedMedia = $ffmpeg->openAdvanced(array('video.mp4')); $advancedMedia ->map(array('0:a'), new Mp3(), 'output.mp3') ->save();
定制
如果需要,您可以额外定制高级媒体的结果ffmpeg命令
$advancedMedia = $ffmpeg->openAdvanced($inputs); $advancedMedia ->setInitialParameters(array('the', 'params', 'that', 'will', 'be', 'added', 'before', '-i', 'part', 'of', 'the', 'command')) ->setAdditionalParameters(array('the', 'params', 'that', 'will', 'be', 'added', 'at', 'the', 'end', 'of', 'the', 'command'));
格式
格式实现了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中的默认输入编解码器时特别有用。
setInitialParameters方法的参数是一个数组。
$format = new FFMpeg\Format\Video\X264(); $format->setInitialParameters(array('-acodec', 'libopus')); $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许可证。
音乐:Waylon Thornton的“Favorite Secrets”来自Free Music Archive CC BY NC SA
音乐:Jahzzar的“Siesta”来自Free Music Archive CC BY SA