Manuel PHP
Précédent |  | Suivant

# id3_get_tag

(PECL)

id3_get_tag -- Récupère toutes les informations stockées dans un tag ID3

## Description

array id3_get_tag ( string filename [, int version] )

id3_get_tag() est utilisée pour récupérer toutes les informations stockées dans un tag ID3 d'un fichier spécifique.

## Liste de paramètres

`filename`

  Le chemin vers le fichier MP3

  Au lieu de passer un nom de fichier, vous pouvez aussi passer un flux de ressource valide.

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

  Depuis la version 0.2, id3_get_tag() supporte également les tags ID3 version 2.2, 2.3 et 2.4. Pour extraire les informations de ces tags, passez une des constantes ID3_V2_2, ID3_V2_3 ou ID3_V2_4 en tant que second paramètre. Les tags ID3 v2.x peuvent contenir beaucoup plus d'informations sur le fichier MP3 que les versions ID3 v1.x.

## Valeurs de retour

Retourne un tableau associatif avec diverses clés, comme : `title`, `artist`, ..

La clé `genre` doit contenir un entier compris entre 0 et 147. Vous pouvez utiliser la fonction id3_get_genre_name() pour convertir ce nombre en une chaîne lisible humainement.

## Exemples

Exemple 1. Exemple avec id3_get_tag()

`<?php $tag = id3_get_tag( "path/to/example.mp3" ); print_r($tag); ?>`

L'exemple ci-dessus va afficher quelque chose de similaire à :

    Array
    (
        [title] => DN-38416
        [artist] => Re:\Legion
        [album] => Reflections
        [year] => 2004
        [genre] => 19
    )

Exemple 2. Exemple avec id3_get_tag()

`<?php $tag = id3_get_tag( "path/to/example2.mp3", ID3_V2_3 ); print_r($tag); ?>`

L'exemple ci-dessus va afficher quelque chose de similaire à :

    Array
    (
        [copyright] => Dirty Mac
        [originalArtist] => Dirty Mac
        [composer] => Marcus Götze
        [artist] => Dirty Mac
        [title] => Little Big Man
        [album] => Demo-Tape
        [track] => 5/12
        [genre] => (17)Rock
        [year] => 2001
    )

## Voir aussi

id3_set_tag()
id3_remove_tag()
id3_get_version()

Précédent | Sommaire | Suivant
id3_get_genre_name | Niveau supérieur | id3_get_version