Manuel PHP
PrécédentSuivant

id3_set_tag

(no version information, might be only in CVS)

id3_set_tag -- Met à jour les informations stockées dans un tag ID3

Description

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

id3_set_tag() est utilisé pour changer les informations stockées dans un tag ID3. Si aucun tag n'est présent, le tag sera ajouté au fichier.

Note : Au lieu d'un nom de fichier, vous pouvez également passer une ressource valide.

Le paramètre optionnel version vous permet de spécifier la version du tag, bien que les fichiers MP3 doivent contenir à la fois les versions 1.x et les versions 2.x.

Exemple 1. Exemple avec id3_set_tag()

<?php
$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 "Le tag a été mis à jour avec succès\n";
}
?>

Si le fichier est accessible en écriture, l'exemple affichera : 

Le tag a été mis à jour avec succès

Note : Actuellement, id3_set_tag() supporte uniquement les versions 1.0 et 1.1.

Les clés suivantes peuvent être utilisées dans le tableau associatif :

Tableau 1. Clés dans le tableau associatif

CléValeur possibledisponible dans la version
titlechaîne de caractères avec un maximum de 30 caractèresv1.0, v1.1
artistchaîne de caractères avec un maximum de 30 caractèresv1.0, v1.1
albumchaîne de caractères avec un maximum de 30 caractèresv1.0, v1.1
year4 chiffresv1.0, v1.1
genrevaleur entière comprise entre 0 et 147v1.0, v1.1
commentchaîne de caractères avec un maximum de 30 caractères (28 en v1.1)v1.0, v1.1
trackentier compris entre 0 et 255v1.1

Voir aussi id3_get_tag(), id3_remove_tag() et id3_get_version().

PrécédentSommaireSuivant
id3_remove_tagNiveau supérieurInformix