id3_set_tag
(PECL id3 >= 0.1)
id3_set_tag — Actualiza la información almacenada en una etiqueta ID3
Descripción
$filename
, array $tag
[, int $version = ID3_V1_0
] )id3_set_tag() Es usada para modificar la información almacenada de una etiqueta ID3. Si la etiqueta no se encuentra presente, será añadida al fichero.
Parámetros
-
filename -
Ruta al fichero MP3
En lugar de un nombre de fichero puede pasarse un contexto de flujos válido.
-
tag -
Un array asociativo de claves de la etiqueta y sus valores
Las siguientes claves pueden ser usadas en el array asociativo:
Claves en el array asociativo clave valor posible 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 dígitos v1.0, v1.1 genre entero 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 entre 0 y 255 v1.1 -
version -
Permite especificar la versión de la etiqueta, esto se debe a que los ficheros MP3 pueden contener ambas versiones de etiquetas, 1.x y 2.x
Valores devueltos
Devuelve TRUE en caso de éxito o FALSE en caso de error.
Ejemplos
Ejemplo #1 Ejemplo de id3_set_tag()
<?php
$datos = array(
"title" => "Re:Start",
"artist" => "Re:\Legion",
"comment" => "A nice track"
);
$resultado = id3_set_tag( "ruta/a/ejemplo.mp3", $datos, ID3_V1_0 );
if ($resultado === true) {
echo "Etiqueta actualizada correctamente\n";
}
?>
Si es posible escribir en el fichero, imprimirá:
Etiqueta actualizada correctamente
Notas
Nota: Actualmente id3_set_tag() solamente soporta las versiones 1.0 y 1.1.
Ver también
- id3_remove_tag() - Elimina una etiqueta ID3 existente
- id3_get_tag() - Obtiene toda la información almacenada en una etiqueta ID3
- id3_get_version() - Obtiene la versión de una etiqueta ID3