Manual do PHP
Anterior |  | Próxima

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

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