xattr_set

(PECL xattr >= 0.9.0)

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

Описание

xattr_set ( string $filename , string $name , string $value , int $flags = 0 ) : bool

Эта функция устанавливает расширенный атрибут файла.

Расширенные атрибуты имеют два различных пространства имен: пользовательское и корневое (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() - Удаление расширенных атрибутов файла