Общие понятия и применение

1. 1С-Битрикс: События
Общие понятия и применение

2. Что такое события?
Иногда бывает необходимо повлиять на ход
выполнения какой-нибудь API функции. Но если ее
изменить, то эти изменения будут утеряны при
очередном обновлении. Для таких случаев и
разработана система событий. В ходе выполнения
некоторых API функций, в определённых точках
установлены вызовы определённых функций, так
называемых обработчиков события.

3. Как работает?
foreach (GetModuleEvents("iblock", "OnIBlockElementAdd", true) as $arEvent) {
ExecuteModuleEventEx($arEvent, array($arFields));
}
foreach(GetModuleEvents("search", "BeforeIndex", true) as $arEvent){
$arEventResult = ExecuteModuleEventEx($arEvent, array($arFields));
if (is_array($arEventResult))
$arFields = $arEventResult;
}

4. Как найти событие в документации?
http://dev.1c-bitrix.ru/api_help/:module:/events/
где :module: - название модуля, может быть:
"sale", "iblock", "search", "catalog", "main"...
Например: http://dev.1c-bitrix.ru/api_help/iblock/events/

5. Применение
Добавляем код в init.php
AddEventHandler("iblock", "OnBeforeIBlockElementAdd", Array("MyClass", "OnBeforeIBlockElementAddHandler"));
class MyClass {
function OnBeforeIBlockElementAddHandler(&$arFields) {
...
}
}
AddEventHandler("iblock", "OnBeforeIBlockElementAdd", "OnBeforeIBlockElementAddHandler");
function OnBeforeIBlockElementAddHandler(&$arFields) {
...
}

6. Дебажим
...
function OnBeforeIBlockElementAddHandler(&$arFields) {
file_put_contents($_SERVER["DOCUMENT_ROOT"].'/element_add.txt',
print_r(array($arFields),true),FILE_APPEND);
}
Дебаг событий проводится выводом массива
в файл, например, следующим образом:

7. Пример 1 (рабочий)
...
function OnBeforeIBlockElementAddHandler(&$arFields)
{
$code = Cutil::translit($arFields['NAME'], "ru", array());
$arFields['CODE'] = preg_replace('/d/', '', $code);
}
Событие на отслеживание Добавление/изменение элемента. В данном примере отслеживаем поле
"NAME" элемента, делаем его транслитерацию, убираем цифры и добавляем в "CODE"

8. Пример 2 (рабочий + полезный)
AddEventHandler("main", "OnEpilog", "Generate404");
function Generate404() {
if (defined('ERROR_404') && ERROR_404=='Y' || CHTTP::GetLastStatus() == "404 Not Found"){
GLOBAL $APPLICATION;
$APPLICATION->RestartBuffer();
require ($_SERVER["DOCUMENT_ROOT"]."/bitrix/modules/main/include/prolog_before.php");
require $_SERVER['DOCUMENT_ROOT'].SITE_TEMPLATE_PATH.'/header.php';
require $_SERVER['DOCUMENT_ROOT'].'/404.php';
require $_SERVER['DOCUMENT_ROOT'].SITE_TEMPLATE_PATH.'/footer.php';
}
}
Событие срабатывает после того, как битрикс соберет html и компоненты. В данном случае, мы
отслеживаем был ли ранее задан статус 404 и если он задан изменяем контентную область на
информацию из файла 404.php. Этот код используется на боевом сайте.