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 permettent 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