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().
