adamsolaris/yii2-bitrix-log

Bitrix24 chat log target for Yii2

1.1.0 2026-03-30 17:39 UTC

Requires

• php: >=7.1.0
• yiisoft/yii2: ~2.0.0
• yiisoft/yii2-httpclient: ~2.0.0

MIT

• AdamSolaris

• log
• yii2
• bitrix
• Bitrix24

README

Лог-таргет для отправки сообщений об ошибках и событиях в чат Bitrix24 через входящий вебхук.

Особенности

• Отправка сообщений в конкретный диалог (чат) Bitrix24.
• Поддержка BB-кодов Bitrix (жирный текст, блоки кода).
• Автоматическая очистка от системного мусора Yii2 (дампы $_GET, $_POST и т.д.).
• Поддержка эмодзи для уровней логов.
• Работает как в Web, так и в Console приложениях.

Установка

Установите выполнив команду:

composer require AdamSolaris/yii2-bitrix-log

Либо добавьте в composer.json:

"repositories": [
    {
        "type": "vcs",
        "url": "https://github.com/AdamSolaris/yii2-bitrix-log"
    }
],
"require": {
    "require": {
    "adamsolaris/yii2-bitrix-log": "dev-master"
}

Настройка

В конфигурации приложения (common/config/main.php или backend/config/main.php) добавьте новый таргет в компонент log:

'components' => [
    'log' => [
        'targets' => [
            [
                'class' => 'AdamSolaris\bitrixlog\Target',
                'address' => 'your-domain.bitrix24.ru',
                'userId' => '123',
                'webhook' => 'your-webhook-token',
                'dialogId' => 'chat456', // ID чата или пользователя
                'categories' => ['error', 'warning'], // Категории для отслеживания
                'levels' => ['error', 'warning'],
            ],
        ],
    ],
],

Параметры:

• address: Домен вашего Bitrix24 (например, company.bitrix24.ru).
• userId: ID пользователя, создавшего вебхук.
• webhook: Токен входящего вебхука.
• dialogId: ID диалога, куда отправлять сообщения. Для чатов обычно начинается с chat, например chat12345.
• splitLongMessages: Разбивать ли большие сообщения на несколько и отправлять порциями (по умолчанию - true). Если выключить, то сообщение будет обрезаться.

Лицензия

MIT