Документация для разработчиков
Темная тема

SetFileAccessPermission

Описание и параметры

bool
CMain::SetFileAccessPermission(
	string path,
	array permissions,
	bool overwrite = true
)

Устанавливает права доступа к файлу или каталогу. Возвращает "true" - если установка прав произведена успешно и "false" - в случае ошибки. Нестатический метод.

Параметры

ПараметрОписание
path Путь к файлу или папке относительно корня. В случае многосайтовой версии, если корневой каталог у сайтов разный, то в данном параметре необходимо передавать массив вида:
array("ID сайта", "Путь к файлу или папке относительно корня")
permissions Массив с правами доступа вида Array("ID группы пользователей"=>"право доступа" [, ...]). В качестве "право доступа" возможны следующие значения:
  • D - доступ запрещён
  • R - чтение (право просмотра содержимого файла)
  • U - документооборот (право на редактирование файла в режиме документооборота)
  • W - запись (право на прямое редактирование)
  • X - полный доступ (право на прямое редактирование файла и право на изменение прав доступа на данных файл)
В качестве "ID группы пользователей" также может быть задан символ "*", что означает - "для всех групп пользователей".
overwrite Если значение - "true", то существующие права будут перезаписаны.
Необязателен. По умолчанию - "true".

Примеры использования

<?
// установим на файл /ru/index.php следующие права:
// для группы # 23 - право чтения файла
// для группы # 5 - право прямого изменения файла
// для всех остальных групп - доступ к файлу закрыт
if ($APPLICATION->SetFileAccessPermission("/ru/index.php", 
	array("23" => "R", "5" => "W", "*" => "D")))
	ShowNote("Права на файл успешно установлены.");
?>


© «Битрикс», 2001-2024, «1С-Битрикс», 2024