Forum und email

xattr_set

(PECL xattr:0.9-1.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 falhas.

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'));
?>