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 possible | disponible dans la version |
|---|
| title | chaîne de caractères avec un maximum de 30 caractères | v1.0, v1.1 |
| artist | chaîne de caractères avec un maximum de 30 caractères | v1.0, v1.1 |
| album | chaîne de caractères avec un maximum de 30 caractères | v1.0, v1.1 |
| year | 4 chiffres | v1.0, v1.1 |
| genre | valeur entière comprise entre 0 et 147 | v1.0, v1.1 |
| comment | chaîne de caractères avec un maximum de 30 caractères (28 en v1.1) | v1.0, v1.1 |
| track | entier compris entre 0 et 255 | v1.1 |
Voir aussi
id3_get_tag(),
id3_remove_tag() et
id3_get_version().
