XLIX. Fonctions ID3

Introduction

Ces fonctions vous permettent de lire et de manipuler les tags ID3. Les tags ID3 sont utilisés dans les fichiers MP3 pour sotcker le titre d'une chanson, tout comme des informations sur l'artiste, l'album, le genre, l'année et le numéro de la piste.

Depuis la version 0.2, il est également possible d'extraire des champs texte depuis des tags ID3 v2.2+.

Pré-requis

Ces fonctions sont disponibles dans le module PHP standard, qui est toujours accessible.

Installation

id3 est une partie de PECL et peut être installé en utilisant l'installeur Pear. Pour compiler PHP avec le support ID3, téléchargez le code source, mettez-le dans le dossier php-src/ext/id3 et compilez en spécifiant --enable-id3.

Configuration à l'exécution

Cette extension ne définit aucune directive de configuration.

Types de ressources

Cette extension ne définit aucune ressource.

Constantes pré-définies

La plupart des fonctions ID3 vous permet soit de spécifier, soit de retourner un tag. Pour spécifier la version, utilisez une de ces constantes :

ID3_V1_0 (entier)

ID3_V1_0 est utilisé si vous travaillez avec des tags ID3 V1.0. Ces tags peuvent contenir les champs title, artist, album, genre, year et comment.

ID3_V1_1 (entier)

ID3_V1_1 est utilisé si vous travaillez avec des tags ID3 V1.1. Ces tags peuvent contenir tous les champs de la version 1.0 ainsi qu'un champ représentant le numéro de la piste.

ID3_V2_1 (entier)

ID3_V2_1 est utilisé si vous travaillez avec des tags ID3 V2.1.

ID3_V2_2 (entier)

ID3_V2_2 est utilisé si vous travaillez avec des tags ID3 V2.2 tags.

ID3_V2_3 (entier)

ID3_V2_3 est utilisé si vous travaillez avec des tags ID3 V2.3 tags.

ID3_V2_4 (entier)

ID3_V2_4 est utilisé si vous travaillez avec des tags ID3 V2.4 tags.

ID3_BEST (entier)

ID3_BEST est utilisé si vous voulez laisser les fonctions id3 déterminer quelle version de tags doit être utilisée.

Table des matières
id3_get_frame_long_name -- Récupère le nom long d'un champs ID3v2
id3_get_frame_short_name -- Récupère le nom court d'un champs ID3v2
id3_get_genre_id -- Récupération d'un id pour un genre
id3_get_genre_list -- Récupère toutes les valeurs possibles du genre
id3_get_genre_name -- Récupère le nom pour un id de genre
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
id3_remove_tag -- Efface un tag ID3
id3_set_tag -- Met à jour les informations stockées dans un tag ID3