id3_set_tag
(PECL id3:0.1-0.2)
id3_set_tag — Modifica la información contenida en la etiqueta ID3
Descripción
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.
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 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.
Example#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
Note: 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:
| 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().