公众号模块 朋友圈广告12.8源码

# php-ffmpeg [](http://travis-ci.org/PHP-FFMpeg/PHP-FFMpeg) [](https://insight.sensiolabs.com/projects/607f3111-e2d7-44e8-8bcc-54dd64521983) An Object-Oriented library to convert video/audio files with FFmpeg / AVConv. Check another amazing repo: [PHP FFMpeg extras](https://github.com/alchemy-fr/PHP-FFMpeg-Extras), you will find lots of Audio/Video formats there. ## Your attention please ### How this library works: 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 explicitly give the binaries path on load. For Windows users: Please find the binaries at http://ffmpeg.zeranoe.com/builds/. ### Known issues: - Using rotate and resize will produce a corrupted output when using [libav](http://libav.org/) 0.8. The bug is fixed in version 9. This bug does not appear in latest ffmpeg version. ## Installation The recommended way to install PHP-FFMpeg is through [Composer](https://getcomposer.org). ```bash $ composer require php-ffmpeg/php-ffmpeg ``` ## Basic Usage ```php 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'); ``` ## Documentation This documentation is an introduction to discover the API. It's recommended to browse the source code as it is self-documented. ### FFMpeg `FFMpeg\FFMpeg` is the main object to use to manipulate medias. To build it, use the static `FFMpeg\FFMpeg::create`: ```php $ffmpeg = FFMpeg\FFMpeg::create(); ``` FFMpeg will autodetect ffmpeg and ffprobe binaries. If you want to give binary paths explicitly, you can pass an array as configuration. A `Psr\Logger\LoggerInterface` can also be passed to log binary executions. ```php $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); ``` ### Manipulate media `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. ```php $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. ### Video `FFMpeg\Media\Video` can be transcoded, ie: change codec, isolate audio or video. Frames can be extracted. ##### Transcoding 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. ```php $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'); ``` Transcoding progress can be monitored in realtime, see Format documentation below for more information. ##### Extracting image You can extract a frame at any timecode using the `FFMpeg\Media\Video::frame` method. This code returns 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. ```php $frame = $video->frame(FFMpeg\Coordinate\TimeCode::fromSeconds(42)); $frame->save('image.jpg'); ``` If you want to extract multiple images from the video, you can use the following filter: ```php $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'); ``` By default, this will save the frames as `jpg` images. You are able to override this using `setFrameFileType` to save the frames in another format: ```php $frameFileType = 'jpg'; // either 'jpg', 'jpeg' or 'png' $filter = new ExtractMultipleFramesFilter($frameRate, $destinationFolder); $filter->setFrameFileType($frameFileType); $video->addFilter($filter); ``` ##### Clip Cuts the video at a desired point. Use input seeking method. It is faster option than use filter clip. ```php $clip = $video->clip(FFMpeg\Coordinate\TimeCode::fromSeconds(30), FFMpeg\Coordinate\TimeCode::fromSeconds(15)); $clip->save(new FFMpeg\Format\Video\X264(), 'video.avi'); ``` The clip filter takes two parameters: - `$start`, an instance of `FFMpeg\Coordinate\TimeCode`, specifies the start point of the clip - `$duration`, optional, an instance of `FFMpeg\Coordinate\TimeCode`, specifies the duration of the clip On clip you can apply same filters as on video. For example resizing filter. ```php $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'); ``` ##### Generate a waveform You can generate a waveform of an audio file using the `FFMpeg\Media\Audio::waveform` method. This code returns a `FFMpeg\Media\Waveform` instance. You can optionally pass dimensions as the first two arguments and an array of hex string colors for ffmpeg to use for the waveform, see dedicated documentation below for more information. The output file MUST use the PNG extension. ```php $waveform = $audio->waveform(640, 120, array('#00FF00')); $waveform->save('waveform.png'); ``` If you want to get a waveform from a video, convert it in an audio file first. ```php // 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' ); ``` ##### Filters 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 ```php $video ->filters() ->resize($dimension, $mode, $useStandards) ->framerate($framerate, $gop) ->synchronize(); ``` ###### Rotate Rotates a video to a given angle. ```php $video->filters()->rotate($angle); ``` The `$angle` parameter must be one of the following constants : - `FFMpeg\Filters\Video\RotateFilter::ROTATE_90`: 90° clockwise - `FFMpeg\Filters\Video\RotateFilter::ROTATE_180`: 180° - `FFMpeg\Filters\Video\RotateFilter::ROTATE_270`: 90° counterclockwise ###### Resize Resizes a video to a given size. ```php $video->filters()->resize($dimension, $mode, $useStandards); ``` The resize