xattr_set

(PECL xattr >= 0.9.0)

xattr_set — Establece un atributo extendido

Descripción

bool xattr_set ( string $filename , string $name , string $value [, int $flags = 0 ] )

Esta función establece el valor de un atributo extendido del archivo.

Los atributos extendidos tienen dos espacios de nombres diferentes: de usuario y raíz. El de usuario está disponible para todos los usuarios, mientras que el espacio de nombres raíz está disponible sólo para usuarios con privilegios root. xattr opera en el espacio de nombres de usuario por defecto, pero esto puede ser cambiado con el parámetro flags.

Parámetros

filename

El archivo en el que se establece el atributo.

name

El nombre del atributo extendido. Este atributo se crea si no existe o reemplazado si ya existe. Puede cambiar este comportamiento mediante el uso de los parámetros flags.

value

El valor del atributo.

flags

Banderas xattr soportadas
XATTR_CREATE La función falla si el atributo extendido ya existe.
XATTR_REPLACE La función falla si el atributo extendido no existe.
XATTR_DONTFOLLOW No sigue el enlace simbólico pero se puede operar en este.
XATTR_ROOT Establece atributos en la raíz (segura) de espacio de nombres. Requiere privilegios de administrador.

Valores devueltos

Devuelve TRUE en caso de éxito o FALSE en caso de error.

Ejemplos

Ejemplo #1 Establece atributos extendidos en archivo .wav

<?php
$file = 'my_favourite_song.wav';
xattr_set($file, 'Artist', 'Someone');
xattr_set($file, 'My ranking', 'Good');
xattr_set($file, 'Listen count', '34');

/* ... other code ... */

printf("You've played this song %d times", xattr_get($file, 'Listen count')); 
?>

Ver también