(PECL id3 >= 0.1)
id3_set_tag — Actualiza la información almacenada en una etiqueta ID3
$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.
filenameRuta al fichero MP3
En lugar de un nombre de fichero puede pasarse un contexto de flujos válido.
tagUn array asociativo de claves de la etiqueta y sus valores
Las siguientes claves pueden ser usadas 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 |
versionPermite 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
Devuelve TRUE en caso de éxito o FALSE en caso de error.
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
Nota: Actualmente id3_set_tag() solamente soporta las versiones 1.0 y 1.1.