(PECL id3 >= 0.1)
id3_set_tag — Met à jour les informations stockées dans un tag ID3
$filename
, array $tag
[, int $version = ID3_V1_0
] )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.
filename
Le chemin vers le fichier MP3
Au lieu d'un nom de fichier, vous pouvez également passer une ressource valide.
tag
Un tableau associatif de clés et de valeurs de tags
Les clés suivantes peuvent être utilisées 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 digits | 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 |
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.
Cette fonction retourne TRUE en cas de
succès ou FALSE si une erreur survient.
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.