Delicious Bookmark this on Delicious Share on Facebook SlashdotSlashdot It! Digg! Digg



PHP : Function Reference : ID3 Functions : id3_get_tag

id3_get_tag

Get all information stored in an ID3 tag (PECL id3:0.1-0.2)
array id3_get_tag ( string filename [, int version] )

id3_get_tag() is used to get all information stored in the id3 tag of the specified file.

Parameters

filename

The path to the MP3 file

Instead of a filename you may also pass a valid stream resource

version

Allows you to specify the version of the tag as MP3 files may contain both, version 1.x and version 2.x tags

Since version 0.2 id3_get_tag() also supports ID3 tags of version 2.2, 2.3 and 2.4. To extract information from these tags, pass one of the constants ID3_V2_2, ID3_V2_3 or ID3_V2_4 as the second parameter. ID3 v2.x tags can contain a lot more information about the MP3 file than ID3 v1.x tags.

Return Values

Returns an associative array with various keys like: title, artist, ..

The key genre will contain an integer between 0 and 147. You may use id3_get_genre_name() to convert it to a human readable string.

Examples

Example 973. id3_get_tag() example

<?php
$tag
= id3_get_tag( "path/to/example.mp3" );
print_r($tag);
?>

The above example will output something similar to:

Array
(
   [title] => DN-38416
   [artist] => Re:\Legion
   [album] => Reflections
   [year] => 2004
   [genre] => 19
)


Example 974. id3_get_tag() example

<?php
$tag
= id3_get_tag( "path/to/example2.mp3", ID3_V2_3 );
print_r($tag);
?>

The above example will output something similar to:

Array
(
   [copyright] => Dirty Mac
   [originalArtist] => Dirty Mac
   [composer] => Marcus Götze
   [artist] => Dirty Mac
   [title] => Little Big Man
   [album] => Demo-Tape
   [track] => 5/12
   [genre] => (17)Rock
   [year] => 2001
)


Code Examples / Notes » id3_get_tag

patrik weibull

The function generates a SEGFAULT (!) if ran on mp3 files containing tags from different id3-versions. Therefore, you should always use the optional version parameter, such as
id3_get_tag($yourfile, id3_get_version($yourfile))


jbwalker

I couldn't get this to work in Windows XP. Windows users may be interested to note that the following bug with Windows, reported in Feb 2006, appears not to have been fixed yet.
http://pecl.php.net/bugs/search.php?
   cmd=display&status=Open&package_name[]=id3
(NB you'll have to concat the two lines above)


Change Language


Follow Navioo On Twitter
id3_get_frame_long_name
id3_get_frame_short_name
id3_get_genre_id
id3_get_genre_list
id3_get_genre_name
id3_get_tag
id3_get_version
id3_remove_tag
id3_set_tag
eXTReMe Tracker