# xattr_list

(PECL xattr >= 0.9.0)

xattr_list — Get a list of extended attributes

### 说明

xattr_list ( string `$filename` [, int `$flags` = 0 ] ) : array

This functions gets a list of names of extended attributes of a file.

扩展的属性有两种 不同的命名空间：user 和 root。user 命名空间对所有用户均有效，而 root 命名空间仅对拥有 root 权限的用户有效。 xattr 默认在 user 命名空间上操作，但可使用 `flags` 参数进行更改。

### 参数

`filename`

  The path of the file.

`flags`

  Supported xattr flags
  `XATTR_DONTFOLLOW` | Do not follow the symbolic link but operate on symbolic link itself.
  `XATTR_ROOT` | Set attribute in root (trusted) namespace. Requires root privileges.

### 返回值

This function returns an array with names of extended attributes.

### 范例

Example #1 Prints names of all extended attributes of file

    <?php
    $file = 'some_file';
    $root_attributes = xattr_list($file, XATTR_ROOT);
    $user_attributes = xattr_list($file);

    echo "Root attributes: \n";
    foreach ($root_attributes as $attr_name) {
        printf("%s\n", $attr_name);
    }

    echo "\n User attributes: \n";
    foreach ($attributes as $attr_name) {
        printf("%s\n", $attr_name);
    }

    ?>

### 参见

- xattr_get() - Get an extended attribute