(PECL xattr >= 0.9.0)
xattr_set — Установка расширенных атрибутов файла
$filename
, string $name
, string $value
[, int $flags = 0
] )Эта функция устанавливает расширенный атрибут файла.
Расширенные атрибуты имеют два различных
пространства имен: пользовательское и корневое (root). Пользовательское
пространство имен доступно для всех пользователей, в то время как корневое -
только для пользователей с root-привилегиями. По умолчанию xattr оперирует в
пользовательском пространстве имен, но вы можете изменить это поведение
при помощи аргумента flags.
filenameИмя файла, атрибут которого нужно установить.
name
Имя расширенного атрибута. При его отсутствии атрибут создаётся,
в противном случае - перезаписывается. Вы можете изменить поведение,
используя флаги (flags).
valueЗначение атрибута.
flags
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');
/* ... other code ... */
printf("You've played this song %d times", xattr_get($file, 'Listen count'));
?>