Mp3Info

The fastest PHP library to get mp3 tags&meta.

This class extracts information from mpeg/mp3 audio:

Audio	id3v1 Tags	id3v2 Tags
duration	song
bitRate	artist
sampleRate	album
channel	year
framesCount	comment
codecVersion	genre
layerVersion

1. Usage
2. Performance
3. Console scanner
4. API
   • Audio information
   • Object members
   • Static methods
5. Technical information

Usage

After creating an instance of Mp3Info with passing filename as the first argument to the constructor, you can retrieve data from object properties (listed below).

If you need parse tags, you should set 2nd argument this way:

use wapmorgan\Mp3Info\Mp3Info;
$audio = new Mp3Info($fileName, true);
// or omit 2nd argument to increase parsing speed
$audio = new Mp3Info($fileName);

And after that access object properties to get audio information:

echo 'Audio duration: '.floor($audio->duration / 60).' min '.floor($audio->duration % 60).' sec'.PHP_EOL;
echo 'Audio bitrate: '.($audio->bitRate / 1000).' kb/s'.PHP_EOL;
// and so on ...

To access id3v1 tags use $tags1 property:

echo 'Song '.$audio->tags1['song'].' from '.$audio->tags1['artist'].PHP_EOL;

Performance

• It parses a bunch of mp3 files in less than a half of second (without tags).
• It parses a bunch of mp3 files with their tags in two seconds or less (with both id3v1 and id3v2).

A bunch - 878 megabytes of mp3 files (33 tracks with a total length 8:37:42).

Console scanner

To test Mp3Info you can use built-in script that scans dirs and analyzes all mp3-files inside them. To launch script against current folder:

php bin/scan ./

API

Audio information

Property	Description	Values
$codecVersion	MPEG codec version	1 or 2
$layerVersion	Audio layer version	1 or 2 or 3
$audioSize	Audio size in bytes. Note that this value is NOT equals file size.	int
$duration	Audio duration in seconds.microseconds	like 3603.0171428571 (means 1 hour and 3 sec)
$bitRate	Audio bit rate in bps	like 128000 (means 128kb/s)
$sampleRate	Audio sample rate in Hz	like 44100 (means 44.1KHz)
$isVbr	Contains true if audio has variable bit rate	boolean
$channel	Channel mode	'stereo' or 'dual_mono' or 'joint_stereo' or 'mono'

Object members

• float $_parsingTime

  Contains time spent to read&extract audio information in sec.msec.

• array $tags1

  Audio tags ver. 1 (aka id3v1).

• array $tags2

  Audio tags ver. 2 (aka id3v2).

• public function __construct($filename, $parseTags = false)

  Creates new instance of object and initiate parsing. If second argument is true, audio tags will be parsed.

Static methods

• static public function isValidAudio($filename)

  Checks if file $filename looks like an mp3-file. Returns true if file similar to mp3, otherwise false.

Technical information

Supporting features:

• id3v1
• id3v2.3.0
• Variable Bit Rate (VBR)

Used sources:

• mpeg header description
• id3v2 tag specifications. Сoncretely: id3v2.3.0, id3v2.2.0, id3v2.4.0
• Xing, Info and Lame tags specifications