README

#PHP FFmpeg

一个用于使用 FFmpeg / AVConv 转换视频/音频文件的面向对象库。

查看另一个惊人的仓库： PHP FFMpeg extras，您将在那里找到许多音频/视频格式。

请注意

此库的工作方式

此库需要一个可工作的 FFMpeg 安装。您需要 FFMpeg 和 FFProbe 二进制文件才能使用它。确保这些二进制文件可以通过系统 PATH 定位，以获得二进制检测的好处；否则，您必须在加载时显式地给出二进制文件的路径。

对于 Windows 用户：请从 http://ffmpeg.zeranoe.com/builds/ 获取二进制文件。

已知问题

使用旋转和缩放将在使用 libav 0.8 时产生损坏的输出。此错误已在版本 9 中修复。此错误在最新版本的 ffmpeg 中不存在。

安装

安装 PHP-FFMpeg 的推荐方法是使用 Composer。

{
    "require": {
        "php-ffmpeg/php-ffmpeg": "~0.5"
    }
}

基本用法

$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 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');

过滤器

您可以使用 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()
    ->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 的实例，指定剪辑的持续时间

音频

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()->resample($rate);

重采样过滤器接受两个参数

$rate，有效的音频采样率值（整数）

帧

帧是视频在特定时间码处的图像；有关帧提取的文档请参见上面。

您可以使用FFMpeg\Media\Frame::save方法保存帧。

$frame->save('target.jpg');

此方法有一个可选的布尔参数。将其设置为true以获取准确的图像；执行时间会更长。

格式

格式实现了FFMpeg\Format\FormatInterface。要保存到视频文件，请使用FFMpeg\Format\VideoInterface，对于音频文件请使用FFMpeg\Format\AudioInterface。

格式还可以扩展FFMpeg\Format\ProgressableInterface以获取实时转码信息。

预定义的格式已提供进度信息作为事件。

$format = new Format\Video\X264();
$format->on('progress', function ($video, $format, $percentage) {
    echo "$percentage % transcoded";
});

$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表示点。
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

##与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,
));

API浏览器

浏览API

许可协议

本项目采用MIT许可协议。

soluciones-gbh / php-ffmpeg

维护者

详细信息