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

OnBeforeChangeFile

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

bool функция-обработчик(
	string abs_path,
	string &strContent
);

Событие "OnBeforeChangeFile" вызывается при изменении файла методом $APPLICATION->SaveFileContent, перед его сохранением. Событие добавлено в версии 8.5.1 ядра. Контент в событие передается по ссылке.

Возвращаемое значение

При возврате true поизводится сохранение файла. При возврате false сохранение файла отменяется.

Параметры

ПараметрОписание
abs_pathАбсолютный путь к файлу (включая document_root).
strContentНовое содержимое файла. Значение передается по ссылке. Таким образом, обработчик может изменить содержимое файла перед его сохранением.

Пример функции-обработчика

// файл /bitrix/php_interface/init.php
AddEventHandler("main", "OnBeforeChangeFile", "MyBeforeChangeFile");

public static function MyBeforeChangeFile($abs_path, $content)
{
	if(strpos($content, "Вася") !== false)
	{
		$GLOBALS['APPLICATION']->ThrowException("Вы не можете сохранять слово 'Вася' в документе! (".$abs_path.")");
		return false;
	}
	return true;
}


Пользовательские комментарии

Мы будем рады, если разработчики добавят свои комментарии по практическому использованию методов системы.

Для этого нужно всего лишь авторизоваться на сайте

Но помните, что Пользовательские комментарии, несмотря на модерацию, не являются официальной документацией. Ответственность за их использование несет сам пользователь.

Также Пользовательские комментарии не являются местом для обсуждения функционала. По подобным вопросам обращайтесь на форумы.
© «Битрикс», 2001-2024, «1С-Битрикс», 2024
Наверх