PHP Portal » PHP Handbuch » id3_set_tag

Werbung

id3_set_tag


(PECL id3 >= 0.1)

id3_set_tagManipulation der Informationen in einem ID3-Tag

Beschreibung

bool id3_set_tag ( string $filename , array $tag [, int $version ] )

id3_set_tag() wird verwendet, um die Informationen in einem ID3-Tag zu manipulieren. Wenn kein Tag existiert, so wird es zur Datei hinzugefügt.

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.

PHP Code
1
2
3
4
5
6
7
8
9
$data = array( "title" => "Re:Start", "artist" => "Re:\Legion", "comment" => "A nice track" ); $result = id3_set_tag( "path/to/example.mp3", $data, ID3_V1_0 ); if ($result === true) { echo "Tag succesfully updated\n"; }

Wenn die Datei schreibbar ist, sieht die Ausgabe wie folgt aus:

Tag succesfully updated

Hinweis: Momentan unterstützt id3_set_tag() nur ID3-Tags in den Versionen 1.0 und 1.1.

Folgende Schlüssel können in dem assoziativen Array verwendet werden:

Schlüssel des assoziativen Arrays
Schlüssel möglicher Wert verfügbar in Tag-Version
title String mit maximal 30 Zeichen v1.0, v1.1
artist String mit maximal 30 Zeichen v1.0, v1.1
album String mit maximal 30 Zeichen v1.0, v1.1
year 4-stellige Zahl v1.0, v1.1
genre Ganzzahl zwischen 0 und 147 v1.0, v1.1
comment String mit maximal 30 Zeichen (28 in v1.1) v1.0, v1.1
track Ganzzahl zwischen 0 und 255 v1.1

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