id3_set

Manual de PHP
Anterior		Siguiente

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

Clave	Valores posibles	Disponible en la versión
title	cadena con un máximo de 30 caracteres	v1.0, v1.1
artist	cadena con un máximo de 30 caracteres	v1.0, v1.1
album	cadena con un máximo de 30 caracteres	v1.0, v1.1
year	4 digitos	v1.0, v1.1
genre	entero con un valor entre 0 y 147	v1.0, v1.1
comment	cadena con un máximo de 30 caracteres (28 en v1.1)	v1.0, v1.1
track	entero con un valor entre 0 y 255	v1.1

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

Anterior	Inicio	Siguiente
id3_remove_tag	Subir	Funciones de Informix