PHP 手冊
後退		前進

xattr_set

(PECL)

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

表格 1. 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')); ?>

參見

xattr_get()

xattr_remove()

後退	起點	前進
xattr_remove	上一級	xattr_supported