xattr_set

(PECL xattr >= 0.9.0)

xattr_set — Establece un atributo extendido

Descripción

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

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

xattr_get() - Obtener un atributo extendido
xattr_remove() - Elimina un atributo extendido

add a note

User Contributed Notes 1 note

down

blr at blr dot hu ¶

9 years ago


Be aware when use on filesystem without xattr support, it returns true. (Bug reported)

add a note