Manuel PHP
Précédent |  | Suivant

# id3_set_tag

(PECL)

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.

## 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 :

  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 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, `FALSE` en cas d'échec.

## 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()
id3_get_tag()
id3_get_version()

Précédent | Sommaire | Suivant
id3_remove_tag | Niveau supérieur | Fonctions d'administration d'IIS