xattr_remove
xattr_supported
Funções da xattr
PHP Manual

# xattr_set

(PECL xattr >= 0.9.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 caso de falha.

### 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() - Retorna um atributo extendido
- xattr_remove() - Remove um atributo extendido

xattr_remove
xattr_supported
Funções da xattr
PHP Manual