xattr_set

(PECL xattr >= 0.9.0)

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

Opções (flags) Suportadas por xattr
XATTR_CREATE Função falhará se o atributo extendido já existir.
XATTR_REPLACE Função falhará se atributo extendido não existir.
XATTR_DONTFOLLOW Não segue o link simbólico mas opera no link em si.
XATTR_ROOT Edita atributo no namespace do administrador. Requer privilégios de root.

Valor Retornado

Retorna TRUE em caso de sucesso ou FALSE em caso de falha.

Exemplos

Example #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