(PECL xattr >= 0.9.0)
xattr_set — Edita um atributo extendido
$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
.
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
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. |
Retorna TRUE
em caso de sucesso ou FALSE
em caso de falha.
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'));
?>