id3_set_tag
Manual de PHP
AnteriorSiguiente

id3_set_tag

(PECL)

id3_set_tag -- Modifica la informaci贸n contenida en la etiqueta ID3

Descripci贸n

bool id3_set_tag ( string nombre_archivo, array etiqueta [, int version] )

id3_set_tag() se emplea para modificar la informaci贸n almacenada en una etiqueta ID3. Si el archivo no tiene ninguna etiqueta asociada, se le a帽ade como nueva etiqueta.

Nota: 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 que se va a utilizar, ya que los archivos MP3 pueden contener de forma simultanea etiquetas tanto versi贸n 1.x como versi贸n 2.x.

Ejemplo 1. Ejemplo de id3_set_tag()

<?php
$data = array(
              "title" => "Re:Start",
              "artist" => "Re:\Legion",
              "comment" => "A nice track"
             );
$result = id3_set_tag( "ruta/al/ejemplo.mp3", $data, ID3_V1_0 );
if ($result === true) {
    echo "La etiqueta ha sido modificada correctamente\n";
}
?>

Si el archivo nombre_archivo tiene permiso de escritura, la salida del programa ser谩 la siguiente: 

La etiqueta ha sido modificada correctamente

Nota: Actualmente, la funci贸n id3_set_tag() solamente soporta las versiones 1.0 y 1.1.

El array asociativo empleado puede contener las siguientes claves:

Tabla 1. Claves del array asociativo

ClaveValores posiblesDisponible en la versi贸n
titlecadena con un m谩ximo de 30 caracteresv1.0, v1.1
artistcadena con un m谩ximo de 30 caracteresv1.0, v1.1
albumcadena con un m谩ximo de 30 caracteresv1.0, v1.1
year4 digitosv1.0, v1.1
genreentero con un valor entre 0 y 147v1.0, v1.1
commentcadena con un m谩ximo de 30 caracteres (28 en v1.1)v1.0, v1.1
trackentero con un valor entre 0 y 255v1.1

Vea tambi茅n id3_get_tag(), id3_remove_tag() y id3_get_version().

AnteriorInicioSiguiente
id3_remove_tagSubirIIS Administration Functions