Manuel PHP - 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_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.

Liste de paramètres

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é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 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.

Valeurs de retour

Cette fonction retourne TRUE en cas de succès ou FALSE si une erreur survient.

Exemples

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

Notes

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

Voir aussi

id3_remove_tag() - Efface un tag ID3
id3_get_tag() - Récupère toutes les informations stockées dans un tag ID3
id3_get_version() - Récupère la version d'un tag ID3