array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'es', ), 'this' => array ( 0 => 'function.xattr-set.php', 1 => 'xattr_set', 2 => 'Establece un atributo extendido', ), 'up' => array ( 0 => 'ref.xattr.php', 1 => 'Funciones de xattr', ), 'prev' => array ( 0 => 'function.xattr-remove.php', 1 => 'xattr_remove', ), 'next' => array ( 0 => 'function.xattr-supported.php', 1 => 'xattr_supported', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'es', 'path' => 'reference/xattr/functions/xattr-set.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

xattr_set

(PECL xattr >= 0.9.0)

xattr_set — Establece un atributo extendido

Descripción

function 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: user y root. El espacio de nombres user está disponible para todos los usuarios, mientras que el espacio de nombres root solo está disponible para usuarios con privilegios de root. xattr opera sobre el espacio de nombres user por defecto, pero esto se puede cambiar 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

Esta función retorna true en caso de éxito o false si ocurre un 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'));
?>

Véase también