id3_get_tag

(PECL id3 >= 0.1)

id3_get_tag — Ermitteln aller Informationen in einem ID3-Tag

Beschreibung

array id3_get_tag ( string $filename [, int $version ] )

id3_get_tag() wird verwendet, um alle Informationen in einem ID3-Tag einer bestimmten Datei zu ermitteln.

Hinweis: Anstelle eines Dateinamens können Sie auch eine stream-Ressource übergeben.

Der optionale Parameter version erlaubt es, die Version des zu schreibenden Tags anzugeben. MP3-Dateien können sowohl ID3v1-, als auch ID3v2-Tags enthalten.

Beispiel #1 id3_get_tag() Beispiel


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

Die Ausgabe wird in etwa so aussehen:

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

Der Key genre enthält eine Ganzzahl zwischen 0 and 147. Sie können die Funktion id3_get_genre_name() verwenden, um diese in eine menschenlesbare Form zu bringen.

Seit Version 0.2 unterstützt id3_get_tag() auch ID3-Tags in den Versionen 2.2, 2.3 und 2.4. Übergeben Sie eine der Konstanten ID3_V2_2, ID3_V2_3 oder ID3_V2_4 als zweiten Parameter, um Informationen aus diesen Tags zu lesen.

Beispiel #2 id3_get_tag() Beispiel


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

Die Ausgabe wird in etwa so aussehen:

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
)

ID3v2.x Tags können weit mehr Informationen über eine MP3-Datei enthalten, als ID3v1.x Tags.

Siehe auch id3_set_tag(), id3_remove_tag() und id3_get_version().

add a note User Contributed Notes
id3_get_tag

jbwalker at telus dot net
07-Nov-2006 03:25


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)

add a note

id3_get_version

id3_get_genre_name

Last updated: Fri, 18 May 2012