xattr_set

(no version information, might be only in CVS)

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.

Extended attributes have two different namespaces: user and root namespace. User namespace is available for all users while root namespace is available only for user with root privileges. xattr operates on user namespace by default, but you can change that using flags argument.

Lista de 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 Retornados

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()