alaloul/php-ffmpeg

FFMpeg PHP,一个用于与AVconv / ffmpeg通信的面向对象的库

v0.12 2018-07-06 16:51 UTC

README

Build Status

SensioLabsInsight

一个用于使用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\AudioFFMpeg\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\DefaultVideoFFMpeg\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\FFProbeFFMpeg\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 许可协议进行许可。