xattr_set

(PECL xattr >= 0.9.0)

xattr_set 设置扩展属性

描述

xattr_set(
    字符串 $filename,
    字符串 $name,
    字符串 $value,
    整数 $flags = 0
): 布尔值

此函数设置文件扩展属性的值。

扩展属性有两种不同的命名空间:用户和根。用户命名空间对所有用户可用,而根命名空间仅对具有根权限的用户可用。xattr 默认操作于用户命名空间,但这可以通过 flags 参数更改。

参数

filename

设置属性的文件。

name

扩展属性的名称。如果此属性不存在,则会创建它,否则会被替换。可以使用 flags 参数更改此行为。

value

属性的值。

flags

支持的 xattr 标志
XATTR_CREATE 如果扩展属性已存在,则函数将失败。
XATTR_REPLACE 如果扩展属性不存在,则函数将失败。
XATTR_DONTFOLLOW 不跟踪符号链接,而是在符号链接本身进行操作。
XATTR_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
8 年前
请注意,在没有 xattr 支持的文件系统上使用时,它会返回 true。(已报告错误)
To Top