Last updated: Fri, 22 Aug 2008

id3_get_tag

(PECL id3:0.1-0.2)

id3_get_tag — Obtiene toda la información contenida en la etiqueta ID3

Descripción

array id3_get_tag ( string $nombre_archivo [, int $version ] )

id3_get_tag() se emplea para obtener toda la información almacenada en la etiqueta id3 del archivo indicado mediante el parámetro nombre_archivo .

Note: Además del nombre de un archivo, también se puede indicar el nombre de un recurso de tipo stream.

El parámetro opcional version permite indicar la versión de la etiqueta desde la que se obtiene la información, ya que los archivos MP3 pueden contener de forma simultanea etiquetas tanto versión 1.x como versión 2.x.

Example #1 Ejemplo de id3_get_tag()


<?php
$tag = id3_get_tag( "ruta/al/ejemplo.mp3" );
print_r($tag);
?>

La salida del programa será similar a la siguiente:

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

La clave genre contiene un número entre 0 y 147. Empleando la función id3_get_genre_name() se puede convertir ese número en una cadena de texto con el género musical del archivo.

A partir de la verón 0.2, id3_get_tag() soporta etiquetas ID3 versión 2.2, 2.3 y 2.4. Para obtener la información de esas etiquetas, se debe pasar como segundo parámetro uno de los siguientes valores: ID3_V2_2, ID3_V2_3 o ID3_V2_4.

Example #2 Ejemplo de id3_get_tag()


<?php
$tag = id3_get_tag( "ruta/al/ejemplo2.mp3", ID3_V2_3 );
print_r($tag);
?>

La salida del programa será similar a la siguiente:

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
)

Las etiquetas ID3 v2.x pueden contener mucha más información sobre el archivo MP3 que las etiquetas ID3 v1.x.

Vea también id3_set_tag(), id3_remove_tag() y id3_get_version().