xattr_set
(PECL xattr:0.9-1.0)
xattr_set — Set an extended attribute
說明
bool xattr_set
( string $filename
, string $name
, string $value
[, int $flags
] )
This function sets the value of an extended attribute of a file.
擴充功能的屬性有兩個不同的名稱空間:user 和 root 名稱空間。user 名稱空間對所有用戶均有效,而 root 名稱空間僅對擁有 root 權限的用戶有效。xattr 預設在 user 名稱空間上進行操作,但是可以使用 flags 參數進行更改。
參數
- 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.
Return值
如果成功則回傳 TRUE,失敗則回傳 FALSE。
範例
Example#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'));
?>