Manuel PHP
Précédent |  | Suivant

# xattr_set

(PECL)

xattr_set -- Définie un attribut étendu

## Description

bool xattr_set ( string filename, string name, string value [, int flags] )

xattr_set() définie la valeur d'un attribut étendu nommé `name` à la valeur `value` d'un fichier désigné par le paramètre `path`.

Les attributs étendus ont deux espaces de noms différents : `user` et `root`. L'espace de noms `user` est disponible pour tous les utilisateurs tandis que l'espace de noms `root` n'est disponible que pour les utilisateurs ayant les privilèges `root`. xattr opère sur l'espace de noms `user` par défaut, mais vous pouvez changer cela en utilisant l'argument `flags`.

## Liste de paramètres

`filename`

  Le fichier dans lequel nous devons définir l'attribut.

`name`

  Le nom de l'attribut étendu. Cet attribut sera créé s'il n'existe pas encore ou remplacé sinon. Vous pouvez modifier ce comportement en utilisant le paramètre `flags` parameter.

`value`

  La valeur de l'attribut.

`flags`

  Tableau 1. Flags xattr supportés

  `XATTR_CREATE` | La fonction échouera si l'attribut étendu existe déjà.
  `XATTR_REPLACE` | La fonction échouera si l'attribut étendu n'existe pas.
  `XATTR_DONTFOLLOW` | Ne pas suivre les liens symboliques mais opère directement sur le lien lui-même.
  `XATTR_ROOT` | Définie l'attribut dans l'espace de noms racine. Nécessaire les privilèges d'administrateur.

## Valeurs de retour

Cette fonction retourne `TRUE` en cas de succès, `FALSE` en cas d'échec.

## Exemples

Exemple 1. Définission des attributs étendus dans un fichier .wav

`<?php $file = 'ma_chanson_favorite.wav'; xattr_set($file, 'Artist', 'Someone'); xattr_set($file, 'My ranking', 'Good'); xattr_set($file, 'Listen count', '34'); /* ... autres codes ... */ printf("Vous avez écouté cette chanson %d fois", xattr_get($file, 'Listen count')); ?>`

## Voir aussi

xattr_get()
xattr_remove()

Précédent | Sommaire | Suivant
xattr_remove | Niveau supérieur | xattr_supported