PHP Conference Japan 2024

xattr_set

(PECL xattr >= 0.9.0)

xattr_set 設定延伸屬性

說明

xattr_set(
    字串 $filename,
    字串 $name,
    字串 $value,
    整數 $flags = 0
): 布林值

此函式設定檔案的延伸屬性值。

延伸屬性有兩個不同的命名空間:user 和 root。所有使用者皆可使用 user 命名空間,而 root 命名空間僅供擁有 root 權限的使用者使用。xattr 預設操作 user 命名空間,但可以使用 flags 參數更改。

參數

filename

設定屬性的檔案。

name

延伸屬性的名稱。如果此屬性不存在,則會建立它;否則會取代它。您可以使用 flags 參數更改此行為。

value

屬性的值。

flags

支援的 xattr 旗標
XATTR_CREATE 如果延伸屬性已存在,函式將會失敗。
XATTR_REPLACE 如果延伸屬性不存在,函式將會失敗。
XATTR_DONTFOLLOW 不要追蹤符號連結,而是在符號連結本身上操作。
XATTR_ROOT 在 root(受信任)命名空間中設定屬性。需要 root 權限。

回傳值

成功時回傳 true,失敗時回傳 false

範例

範例 #1 在 .wav 檔案上設定延伸屬性

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

/* ... 其他程式碼 ... */

printf("您已經播放這首歌 %d 次", xattr_get($file, 'Listen count'));
?>

參見

新增筆記

使用者貢獻的筆記 1 則筆記

blr at blr dot hu
9 年前
請注意,在不支援 xattr 的檔案系統上使用時,它會回傳 true。(已回報錯誤)
To Top