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().