xattr_set

(PECL xattr >= 0.9.0)

xattr_set — Set an extended attribute

說明

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

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

擴展的屬性有兩種 不同的命名空間：user 和 root。user 命名空間對所有用戶均有效，而 root 命名空間僅對擁有 root 權限的用戶有效。 xattr 默認在 user 命名空間上操作，但可使用 flags 參數(shù)進行更改。

參數(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.

返回值

成功時返回 true， 或者在失敗時返回 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')); 
?>

參見