xattr_set

(PECL xattr >= 0.9.0)

xattr_set Set an extended attribute

說(shuō)明

xattr_set(
    string $filename,
    string $name,
    string $value,
    int $flags = 0
): bool

This function sets the value of an extended attribute of a file.

擴(kuò)展的屬性有兩種 不同的命名空間:user 和 root。user 命名空間對(duì)所有用戶均有效,而 root 命名空間僅對(duì)擁有 root 權(quán)限的用戶有效。 xattr 默認(rèn)在 user 命名空間上操作,但可使用 flags 參數(shù)進(jìn)行更改。

參數(shù)

filename

The file in which we set the attribute.

name

The name of the extended attribute. This attribute will be created if it doesn't exist or replaced otherwise. You can change this behaviour by using the flags parameter.

value

The value of the attribute.

flags

Supported xattr flags
XATTR_CREATE Function will fail if extended attribute already exists.
XATTR_REPLACE Function will fail if extended attribute doesn't exist.
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.

返回值

成功時(shí)返回 true, 或者在失敗時(shí)返回 false。

范例

示例 #1 Sets extended attributes on .wav file

<?php
$file 
'my_favourite_song.wav';
xattr_set($file'Artist''Someone');
xattr_set($file'My ranking''Good');
xattr_set($file'Listen count''34');

/* ... other code ... */

printf("You've played this song %d times"xattr_get($file'Listen count')); 
?>

參見(jiàn)