CXXXIII. Fonctions xattr

Introduction

L'extension xattr vous permet de manipuler les attributs étendus sur un système de fichiers.

Pré-requis

Pour utiliser xattr, vous avez besoin de la bibliothèque libattr. Elle est disponible sur http://oss.sgi.com/projects/xfs/.

Note : Ces fonctions fonctionnent uniquement sur les systèmes de fichiers qui supportent les attributs étendus et qui les ont activés lors du montage. Les systèmes de fichiers les plus courant supportant les attributs étendus sont ext2, ext3, reiserfs, jfs et xfs.

Installation

xattr est actuellement disponible via PECL http://pecl.php.net/package/xattr.

Si PEAR est disponible sur votre système *nix-like, vous pouvez utiliser l'installeur Pear pour installer l'extension xattr, via la commande : pear -v install xattr.

Vous pouvez toujours télécharger le paquet tar.gz et installer manuellement xattr :

Exemple 1. Installation manuelle de l'extension xattr

gunzip xattr-xxx.tgz
tar -xvf xattr-xxx.tar
cd xattr-xxx
phpize
./configure && make && make install

Constantes pré-définies

Ces constantes sont définies par cette extension, et ne sont disponibles que si cette extension a été compilée avec PHP, ou bien chargée au moment de l'exécution.

XATTR_ROOT (entier)

Définie un attribut dans l'espace de noms racine. Nécessaire les privilèges d'administrateur.

XATTR_DONTFOLLOW (entier)

Ne pas suivre un lien symbolique mais opérer directement sur le lien symbolique.

XATTR_CREATE (entier)

La fonction échouera si l'attribut étendu existe déjà.

XATTR_REPLACE (entier)

La fonction échouera si l'attribut étendu n'existe pas.

Table des matières
xattr_get --  Récupère un attribut étendu
xattr_list --  Récupère une liste d'attributs étendus
xattr_remove --  Efface un attribut étendu
xattr_set --  Définie un attribut étendu
xattr_supported --  Vérifie si un système de fichier supporte les attributs étendus