xattr_set
(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-флаги 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'));
?>
Смотрите также
- xattr_get() - Получение расширенных атрибутов файла
- xattr_remove() - Удаление расширенных атрибутов файла
Коментарии
Be aware when use on filesystem without xattr support, it returns true. (Bug reported)