Пользовательские обработчики событий в платформе 1С-Битрикс

Расширенные примеры, выходящие за рамки типовых сценариев, помогут глубже понять возможности событийной модели 1С-Битрикс.

// Пример 1. Обработчик, отправляющий уведомление в Telegram при добавлении элемента
AddEventHandler("iblock", "OnAfterIBlockElementAdd", function(&$arFields) {
    $message = "Новый элемент инфоблока ".$arFields["IBLOCK_ID"].": ".$arFields["NAME"];
    $telegramToken = "ваш_токен";
    $chatId = "ваш_chat_id";
    $url = "https://api.telegram.org/bot{$telegramToken}/sendMessage?chat_id={$chatId}&text=".urlencode($message);
    file_get_contents($url);
});

// Результат: при каждом добавлении элемента в инфоблок бот присылает сообщение в чат.
// При ошибке (неверный токен) скрипт не упадёт, но сообщение не отправится.

// Пример 2. Обработчик события с использованием агента для отложенной обработки
AddEventHandler("iblock", "OnAfterIBlockElementAdd", "scheduleHeavyTask");

function scheduleHeavyTask(&$arFields) {
    $elementId = $arFields["ID"];
    // Создаём агент, который выполнит задачу через 5 минут
    \CAgent::AddAgent(
        "heavyProcessing(".intval($elementId).");",
        "iblock",
        "N",
        300
    );
    return true;
}

function heavyProcessing($elementId) {
    // Тяжёлая обработка (генерация отчёта, интеграция со сторонним API)
    $element = \CIBlockElement::GetByID($elementId)->GetNext();
    if ($element) {
        // ... логика ...
    }
}

// Агент будет выполняться каждые 5 минут (если не удалён) до тех пор,
// пока функция не вернёт пустую строку, после чего агент удаляется.
// Важно: функция должна быть объявлена как public static или обычная функция.

// Пример 3. Передача дополнительных параметров через Closure и use
AddEventHandler("main", "OnBeforeUserAdd", function(&$arFields) use ($someExternalConfig) {
    $arFields["UF_EXTERNAL_ID"] = $someExternalConfig["prefix"].$arFields["LOGIN"];
});

// Closure позволяет передать в обработчик внешние переменные, что удобно для динамической конфигурации.
// С PHP 5.3+ такой подход допустим, но в init.php лучше избегать замыканий, если не уверены в версии PHP.

// Пример 4. Отмена события через возврат false и добавление ошибки
AddEventHandler("sale", "OnBeforeOrderAdd", function(&$arFields, &$arErrors) {
    if (checkUserLimit()) {
        $arErrors[] = "Превышен лимит заказов на сегодня";
        return false;
    }
});
// Обработчик проверяет условие и, при его выполнении, блокирует создание заказа.

// Если функция возвращает false, событие считается отменённым. 
// Ошибка будет показана пользователю на странице оформления заказа.

// Пример 5. Подписка на событие с помощью EventManager в модуле
\Bitrix\Main\EventManager::getInstance()->registerEventHandlerCompatible(
    "crm",
    "OnAfterCrmLeadAdd",
    "my.module",
    "\MyModule\LeadHandler",
    "onLeadAdded"
);

class MyModule\LeadHandler {
    public static function onLeadAdded(\Bitrix\Main\Event $event) {
        $leadId = $event->getParameter("FIELDS")["ID"];
        // Дальнейшая логика (отправка внешнему API)
    }
}

// В коробочной версии Битрикса для CRM событий лучше использовать registerEventHandlerCompatible,
// так как оно гарантирует совместимость с разными версиями модуля crm.