#PHP FFmpeg
An Object Oriented library to convert video/audio files with FFmpeg / AVConv.
Check another amazing repo : PHP FFMpeg extras, you will find lots of Audio/Video formats there.
This library requires a working FFMpeg install. You will need both FFMpeg and FFProbe binaries to use it. Be sure that these binaries can be located with system PATH to get the benefit of the binary detection, otherwise you should have to explicitely give the binaries path on load.
For Windows users : Please find the binaries at http://ffmpeg.zeranoe.com/builds/.
- Using rotate and resize will produce a corrupted output when using libav 0.8. The bug is fixed in version 9. This bug does not appear in latest ffmpeg version.
The recommended way to install PHP-FFMpeg is through Composer.
{
"require": {
"php-ffmpeg/php-ffmpeg": "~0.4"
}
}
$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');
This documentation is an introduction to discover the API. It's recommended to browse the source code as it is self-documented.
FFMpeg\FFMpeg
is the main object to use to manipulate medias. To build it,
use the static FFMpeg\FFMpeg::create
:
$ffmpeg = FFMpeg\FFMpeg::create();
FFMpeg will autodetect ffmpeg and ffprobe binaries. If you want to give binary
paths explicitely, you can pass an array as configuration. A Psr\Logger\LoggerInterface
can also be passed to log binary executions.
$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
creates media based on URIs. URIs could be either a pointer to a
local filesystem resource, an HTTP resource or any resource supported by FFmpeg.
Note : To list all supported resource type of your FFmpeg build, use the
-protocols
command :
ffmpeg -protocols
To open a resource, use the FFMpeg\FFMpeg::open
method.
$ffmpeg->open('video.mpeg');
Two types of media can be resolved : FFMpeg\Media\Audio
and FFMpeg\Media\Video
.
A third type, FFMpeg\Media\Frame
, is available through videos.
FFMpeg\Media\Video
can be transcoded, ie : change codec, isolate audio or
video. Frames can be extracted.
You can transcode videos using the FFMpeg\Media\Video:save
method. You will
pass a FFMpeg\Format\FormatInterface
for that.
Please note that audio and video bitrate are set on the format.
$format = new Format\Video\X264();
$format->on('progress', function ($video, $format, $percentage) {
echo "$percentage % transcoded";
});
$format
-> setKiloBitrate(1000)
-> setAudioKiloBitrate(256);
$video->save($format, 'video.avi');
Transcoding progress can be monitored in realtime, see Format documentation below for more informations.
You can extract a frame at any timecode using the FFMpeg\Media\Video::frame
method.
This code return a FFMpeg\Media\Frame
instance corresponding to the second 42.
You can pass any FFMpeg\Coordinate\TimeCode
as argument, see dedicated
documentation below for more information.
$frame = $video->frame(FFMpeg\Coordinate\TimeCode::fromSeconds(42));
$frame->save('image.jpg');
You can apply filters on FFMpeg\Media\Video
with the FFMpeg\Media\Video::addFilter
method. Video accepts Audio and Video filters.
You can build your own filters and some are bundled in PHP-FFMpeg - they are
accessible through the FFMpeg\Media\Video::filters
method.
Filters are chainable
$video
->filters()
->resize($dimension, $mode, $useStandards)
->framerate($framerate, $gop)
->synchronize();
Rotates a video to a given angle.
$video->filters()->rotate($angle);
The $angle
parameter must be one of the following constants :
FFMpeg\Filters\Video\RotateFilter::ROTATE_90
: 90° clockwiseFFMpeg\Filters\Video\RotateFilter::ROTATE_180
: 180°FFMpeg\Filters\Video\RotateFilter::ROTATE_270
: 90° counterclockwise
Resizes a video to a given size.
$video->filters()->resize($dimension, $mode, $useStandards);
The resize filter takes three parameters :
$dimension
, an instance ofFFMpeg\Coordinate\Dimension
$mode
, one of the constantsFFMpeg\Filters\Video\ResizeFilter::RESIZEMODE_*
constants$useStandards
, a boolean to force the use of the nearest aspect ratio standard.
Changes the frame rate of the video.
$video->filters()->framerate($framerate, $gop);
The framerate filter takes two parameters :
$framerate
, an instance ofFFMpeg\Coordinate\Framerate
$gop
, a GOP value (integer)
Synchronizes audio and video.
Some containers may use a delay that results in desynchronized outputs. This filters solves this issue.
$video->filters()->synchronize();
Cuts the video at a desired point.
$video->filters()->clip(FFMpeg\Coordinate\TimeCode::fromSeconds(30), FFMpeg\Coordinate\TimeCode::fromSeconds(15));
The clip filter takes two parameters:
$start
, an instance ofFFMpeg\Coordinate\TimeCode
, specifies the start point of the clip$duration
, optional, an instance ofFFMpeg\Coordinate\TimeCode
, specifies the duration of the clip
FFMpeg\Media\Audio
can be transcoded, ie : change codec, isolate audio or
video. Frames can be extracted.
You can transcode audios using the FFMpeg\Media\Audio:save
method. You will
pass a FFMpeg\Format\FormatInterface
for that.
Please note that audio kilobitrate is set on the audio format.
$format = new Format\Audio\Flac();
$format->on('progress', function ($$audio, $format, $percentage) {
echo "$percentage % transcoded";
});
$format
-> setAudioKiloBitrate(256);
$audio->save($format, 'track.flac');
Transcoding progress can be monitored in realtime, see Format documentation below for more informations.
You can apply filters on FFMpeg\Media\Audio
with the FFMpeg\Media\Audio::addFilter
method. It only accepts audio filters.
You can build your own filters and some are bundled in PHP-FFMpeg - they are
accessible through the FFMpeg\Media\Audio::filters
method.
Resamples an audio file.
$audio->filters()->resample($rate);
The resample filter takes two parameters :
$rate
, a valid audio sample rate value (integer)
A frame is a image at a timecode of a video ; see documentation above about frame extraction.
You can save frames using the FFMpeg\Media\Frame::save
method.
$frame->save('target.jpg');
This method has a second optional boolean parameter. Set it to true to get accurate images ; it takes more time to execute.
A format implements FFMpeg\Format\FormatInterface
. To save to a video file,
use FFMpeg\Format\VideoInterface
, and FFMpeg\Format\AudioInterface
for
audio files.
Format can also extends FFMpeg\Format\ProgressableInterface
to get realtime
informations about the transcoding.
Predefined formats already provide progress informations as events.
$format = new Format\Video\X264();
$format->on('progress', function ($video, $format, $percentage) {
echo "$percentage % transcoded";
});
$video->save($format, 'video.avi');
The callback provided for the event can be any callable.
The easiest way to create a format is to extend the abstract
FFMpeg\Format\Video\DefaultVideo
and FFMpeg\Format\Audio\DefaultAudio
.
and implement the following methods.
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 use many units for time and space coordinates.
FFMpeg\Coordinate\AspectRatio
represents an aspect ratio.FFMpeg\Coordinate\Dimension
represent a dimension.FFMpeg\Coordinate\FrameRate
represent a framerate.FFMpeg\Coordinate\Point
represent a point.FFMpeg\Coordinate\TimeCode
represent a timecode.
FFMpeg\FFProbe
is used internally by FFMpeg\FFMpeg
to probe medias. You can
also use it to extract media metadata.
$ffprobe = FFMpeg\FFProbe::create();
$ffprobe
->streams('/path/to/video/mp4') // extracts streams informations
->videos() // filters video streams
->first() // returns the first video stream
->get('duration'); // returns the duration property
##Using with Silex Microframework
Service provider is easy to set up :
$app = new Silex\Application();
$app->register(new FFMpeg\FFMpegServiceProvider());
$video = $app['ffmpeg']->open('video.mpeg');
Available options are as follow :
$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,
));
Browse the API
This project is licensed under the MIT license.