xattr_set

(PECL)

xattr_set --  Edita um atributo extendido

Descrição

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

Essa função edita o valor de um atributo extendido de um arquivo.

Atributos estendidos tem dois namespaces diferentes: usuário e root. O namespace de usuário esta disponível para todos os usuários enquanto o namespace de root esta disponível apenas para o usuario com privilégios de root. xattr opera no namespace de usuário por padrão, mas você pode mudar isso usando o argumento flags.

Parâmetros

filename

O arquivo no qual o atributo será editado.

name

O nome do atributo extendido. Esse atributo será criado se não existir ou substituído caso contrário. Você pode mudar esse comportamento usando o parâmetro flags.

value

O valor do atributo.

flags

Tabela 1. Opções (flags) Suportadas por xattr

XATTR_CREATEFunção falhará se o atributo extendido já existir.
XATTR_REPLACEFunção falhará se atributo extendido não existir.
XATTR_DONTFOLLOWNão segue o link simbólico mas opera no link em si.
XATTR_ROOTEdita atributo no namespace do administrador. Requer privilégios de root.

Valores de retornado

Retorna TRUE em caso de sucesso ou FALSE em falhas.

Exemplos

Exemplo 1. Edita atributos extendidos em um arquivo .wav

<?php
$arquivo
= 'minha_música_favorita.wav';
xattr_set($arquivo, 'Artista', 'Alguém');
xattr_set($arquivo, 'Minha avaliação', 'Boa');
xattr_set($arquivo, 'Escutei quantas vezes', '34');

/* ... outro código ... */

printf("Você ouviu essa música %d vezes", xattr_get($arquivo, 'Escutei quantas vezes'));
?>

Veja também

xattr_get()
xattr_remove()