README

Allows you easily get meta information about any media file with unified interface. The library has no requirements of external libs or system unitilies.

Supported formats

Audio	Video
aac, amr, flac, mp3, ogg, wav, wma	avi, mkv, mp4, wmv
- length	- length
- bitRate	- width
- sampleRate	- height
- channels	- frameRate

Table of contents:

Usage
API
Why not using getID3?
Technical details

Usage

use wapmorgan\MediaFile\MediaFile;

try {
  $media = MediaFile::open('123.mp3');
  // for audio
  if ($media->isAudio()) {
    $audio = $media->getAudio();
    echo 'Duration: '.$audio->getLength().PHP_EOL;
    echo 'Bit rate: '.$audio->getBitRate().PHP_EOL;
    echo 'Sample rate: '.$audio->getSampleRate().PHP_EOL;
    echo 'Channels: '.$audio->getChannels().PHP_EOL;
  }
  // for video
  else {
    $video = $media->getVideo();
    // calls to VideoAdapter interface
    echo 'Duration: '.$video->getLength().PHP_EOL;
    echo 'Dimensions: '.$video->getWidth().'x'.$video->getHeight().PHP_EOL;
    echo 'Framerate: '.$video->getFramerate().PHP_EOL;
  }
} catch (wapmorgan\MediaFile\Exceptions\FileAccessException $e) {
  // FileAccessException throws when file is not a detected media
} catch (wapmorgan\MediaFile\Exceptions\ParsingException $e) {
   echo 'File is propably corrupted: '.$e->getMessage().PHP_EOL;
}

API

MediaFile

wapmorgan\wapmorgan\MediaFile

Method	Description	Notes
`static open($filename): MediaFile`	Detects file type and format and calls constructor with these parameters.	Throws an `\Exception` if file is not a media or is not accessible.
`isAudio(): boolean`	Returns true if media is just audio.
`isVideo(): boolean`	Returns true if media is a video with audio.
`isContainer(): boolean`	Returns true if media is also a container (can store multiple audios and videos).
`getFormat(): string`	Returns media file format.
`getAudio(): AudioAdapter`	Returns an `AudioAdapter` interface for audio.
`getVideo(): VideoAdapter`	Returns an `VideoAdapter` interface for video.

AudioAdapter

wapmorgan\MediaFile\AudioAdapter

Method	Description
`getLength(): float`	Returns audio length in seconds and microseconds as float.
`getBitRate(): int`	Returns audio bit rate as int.
`getSampleRate(): int`	Returns audio sampling rate as int.
`getChannels(): int`	Returns number of channels used in audio as int.
`isVariableBitRate(): boolean`	Returns whether format support VBR and file has VBR as boolean.
`isLossless(): boolean`	Returns whether format has compression lossless as boolean.

VideoAdapter

wapmorgan\MediaFile\VideoAdapter

Method	Description
`getLength(): int`	Returns video length in seconds and microseconds as float.
`getWidth(): int`	Returns width of video as int.
`getHeight(): int`	Returns height of video as int.
`getFramerate(): int`	Returns video frame rate of video as int.

ContainerAdapter

wapmorgan\MediaFile\ContainerAdapter

Method	Description
`countStreams(): int`	Returns number of streams in container as int.
`countVideoStreams(): int`	Returns number of video streams as int.
`countAudioStreams(): int`	Returns number of audio streams as int.
`getStreams(): array`	Returns streams information as array.

Why not using getID3?

getID3 library is very popular and has a lot of features, but it's old and too slow.

Following table shows comparation of analyzing speed of fixtures, distributed with first release of MediaFile:

File	getID3	MediaFile	Speed gain
video.avi	0.215	0.126	1.71x
video.mp4	3.055	0.429	7.12x
video.wmv	0.354	0.372	0.95x
audio.aac	0.560	0.262	2.13x
audio.amr	8.241	12.248	0.67x
audio.flac	1.880	0.071	26.41x
audio.m4a	13.372	0.169	79.14x
audio.mp3	10.931	0.077	141.54x
audio.ogg	0.170	0.096	1.78x
audio.wav	0.114	0.070	1.64x
audio.wma	0.195	0.158	1.23x

Technical information

Format	Full format name	Specifications	Notes
aac	MPEG 4 Part 12 container with audio only	http://l.web.umkc.edu/lizhu/teaching/2016sp.video-communication/ref/mp4.pdf	Does not provide support of MPEG2-AAC
amr	AMR-NB	http://hackipedia.org/File%20formats/Containers/AMR,%20Adaptive%20MultiRate/AMR%20format.pdf	Does not provide support of AMR-WB
avi	-	http://www.alexander-noe.com/video/documentation/avi.pdf
flac	-	-	Support based on third-party library
mkv	Matroska container	https://www.matroska.org/technical/specs/index.html
mp3	MPEG 1/2 Layer 1/2/3	https://github.com/wapmorgan/mp3info#technical-information
mp4	MPEG 4 Part 12/14 container with few audio and video streams	Part 12 specification: http://l.web.umkc.edu/lizhu/teaching/2016sp.video-communication/ref/mp4.pdf Part 14 extension: https://www.cmlab.csie.ntu.edu.tw/~cathyp/eBooks/14496_MPEG4/ISO_IEC_14496-14_2003-11-15.pdf
ogg	Ogg container with Vorbis audio	https://xiph.org/vorbis/doc/Vorbis_I_spec.html
wav	-	-	Support based on third-party library
wma	ASF container with only one audio stream	http://go.microsoft.com/fwlink/p/?linkid=31334
wmv	ASF container with few audio and video streams	http://go.microsoft.com/fwlink/p/?linkid=31334

wapmorgan / media-file

Maintainers

Details