Manual do PHP
Anterior |  | Próxima

# 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_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.

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

Anterior | Principal | Próxima
xattr_remove | Acima | xattr_supported