|
|
MP3nema 0.01 (Default branch)
08-17-2008
|
|
ID3_GET_TAG(3) 1 ID3_GET_TAG(3) id3_get_tag - Get all information stored in an ID3 tag SYNOPSIS
array id3_get_tag (string $filename, [int $version = ID3_BEST]) DESCRIPTION
id3_get_tag(3) is used to get all information stored in the id3 tag of the specified file. PARAMETERS
o $filename - The path to the MP3 file Instead of a filename you may also pass a valid stream resource o $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(3) also supports ID3 tags of version 2.2, 2.3 and 2.4. To extract information from these tags, pass one of the con- stants 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(3) to convert it to a human readable string. EXAMPLES
Example #1 id3_get_tag(3) 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 #2 id3_get_tag(3) 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 Gotze [artist] => Dirty Mac [title] => Little Big Man [album] => Demo-Tape [track] => 5/12 [genre] => (17)Rock [year] => 2001 ) SEE ALSO
id3_set_tag(3), id3_remove_tag(3), id3_get_version(3). PHP Documentation Group ID3_GET_TAG(3)