logger.php

См. документацию.

<?php
 
namespace Bitrix\Sale\Cashbox;
 
use Bitrix\Main\ArgumentTypeException;
use Bitrix\Main\Config\Option;
use Bitrix\Main\Type\DateTime;
use Bitrix\Sale\Cashbox\Internals\CashboxErrLogTable;

class Logger
{
    /* trace levels */
    protected const TRACE_LEVEL_ERROR = 1;
    protected const TRACE_LEVEL_WARNING = 2;
    protected const TRACE_LEVEL_DEBUG = 3;

    public static function addError(?string $message, $cashboxId = null): void
    {
        self::addToLog($message, $cashboxId, static::TRACE_LEVEL_ERROR);
    }

    public static function addWarning(?string $message, $cashboxId = null): void
    {
        self::addToLog($message, $cashboxId, static::TRACE_LEVEL_WARNING);
    }

    public static function addDebugInfo(?string $message, $cashboxId = null): void
    {
        self::addToLog($message, $cashboxId, static::TRACE_LEVEL_DEBUG);
    }

    private static function validateMessage(?string $message): bool
    {
        return !empty($message);
    }

    private static function checkMessageLevel(int $messageLevel): bool
    {
        return $messageLevel <= self::getLevel();
    }

    private static function addToLog(?string $message, $cashboxId, $messageLevel): void
    {
        if (self::checkMessageLevel($messageLevel) && self::validateMessage($message))
        {
            $data = [
                'CASHBOX_ID' => $cashboxId,
                'MESSAGE' => $message,
                'DATE_INSERT' => new DateTime()
            ];
 
            CashboxErrLogTable::add($data);
        }
    }

    private static function getLevel(): int
    {
        return (int)Option::get('sale', 'cashbox_log_level', static::TRACE_LEVEL_ERROR);
    }
}