xattr_set

(PECL xattr >= 0.9.0)

xattr_set — Установка расширенных атрибутов файла


Описание

bool xattr_set ( string $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 файла
$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() - Удаление расширенных атрибутов файла


Описание на ru2.php.net
Описание на php.ru