xattr_set

xattr_set

(PECL)

xattr_set --  Establece un atributo extendido

Descripci贸n

bool xattr_set ( string nombre_archivo, string atributo, string valor [, int opciones] )

La funci贸n establece el valor de un atributo extendido del archivo.

Extended attributes have two different namespaces: user and root namespace. User namespace is available for all users while root namespace is available only for user with root privileges. xattr operates on user namespace by default, but you can change that using flags argument.

Lista de par谩metros

nombre_archivo

El archivo al que se establecer谩 el atributo.

atributo

Nombre del atributo extendido. El atributo se crea si no existe y se reemplaza si ya exist铆a. Se puede modificar este comportamiento con el par谩metro opciones.

valor

El valor del atributo.

opciones

Tabla 1. Opciones de xattr soportadas

XATTR_CREATELa funci贸n falla si el atributo extendido ya exist铆a.
XATTR_REPLACELa funci贸n falla si el atributo extendido no existe.
XATTR_DONTFOLLOWRealizar las operaciones en el propio enlace simb贸lico (no seguirlo).
XATTR_ROOTEstablecer atributo en el espacio de nombres ra铆z (y de confianza). Requiere privilegios de root.

Valores retornados

Devuelve TRUE si todo se llev贸 a cabo correctamente, FALSE en caso de fallo.

Ejemplos

Ejemplo 1. Establecer atributos extendidos en un archivo de extensi贸n .wav

<?php
$archivo
= 'mi_cancion_favorita.wav';
xattr_set($archivo, 'Artista', 'Algun artista');
xattr_set($archivo, 'Mi nota', 'Buena');
xattr_set($archivo, 'Veces escuchada', '34');

/* ... mas codigo ... */

printf("Has escuchado esta cancion %d veces", xattr_get($archivo, 'Veces escuchada'));
?>

Ver tambi茅n

xattr_get()
xattr_remove()