README

示例：在 Bitrix 项目中实际应用 Symfony 通知器。

发送项目中的致命错误消息到配置的通道：短信、邮件、聊天（包括 Telegram）。

重要

此模块依赖于安装、激活和配置模块 proklung.notifier。没有它将无法工作（也不会有错误提示）。

安装

主要项目的 composer.json

  "extra": {
    "installer-paths": {
      "./bitrix/modules/{$name}/": ["type:bitrix-d7-module", "type:bitrix-module"],
      "./bitrix/components/{$name}/": ["type:bitrix-d7-component", "type:bitrix-component"],
      "./bitrix/templates/{$name}/": ["type:bitrix-d7-template", "type:bitrix-theme"]
    }
  }

和

    "repositories": [
        {
          "type": "git",
          "url": "https://github.com/proklung/bitrix.error.notifier.module"
        }
    ]

$ composer require proklung/bitrix-error-notifier-module

在网站的行政界面 bitrix/admin/partner_modules.php 中安装模块 bitrix.error.notifier

init.php:

use Bitrix\Main\Loader;

Loader::includeModule('proklung.notifier');

使用

/bitrix/.settings.php:

use Symfony\Component\Notifier\Notification\Notification;

return [
    'exception_handling' =>
        array(
            'value' =>
                array(
                    'debug' => env('DEBUG', false),
                    'handled_errors_types' => 4437,
                    'exception_errors_types' => 4437,
                    'ignore_silence' => false,
                    'assertion_throws_exception' => true,
                    'assertion_error_type' => 256,
                    'log' => array (
                        'class_name' => \Proklung\Error\Notifier\ErrorHandler::class,
                        'required_file' => 'bitrix/modules/proklung.error.notifier/lib/ErrorHandler.php',
                        'settings' => array (
                            'types' => [
                                \Bitrix\Main\Diag\ExceptionHandlerLog::UNCAUGHT_EXCEPTION,
                                \Bitrix\Main\Diag\ExceptionHandlerLog::IGNORED_ERROR,
                                \Bitrix\Main\Diag\ExceptionHandlerLog::FATAL,
                            ],
                            // Получатель почты; перебивает параметры родительского модуля
                            'recipient' => 'email@gmail.com',
                            // Или какой-нибудь иной способ различения dev/prod среды
                            // По умолчанию - dev
                            'env' => env('DEBUG', false) ? 'dev' : 'prod',
                            // В каком окружении работать. По умолчанию - prod.
                            'allowed_env' => ['dev', 'prod'],
                            // Уровень важности согласно channel_policy (см. документацию к модулю proklung.notifier)
                            // По умолчанию - urgent
                            'importancy' => Notification::IMPORTANCE_URGENT,
                        ),
                    ),
                ),
            'readonly' => false,
        ),
];

注意事项

1. 错误消息只会发送一次（否则可能导致消息洪水）。每天通过代理清除已发送通知的信息表，过程从头开始。