Подключение модуля Лог операций

Как подключить модуль?

Подключение модуля осуществляется стандартными методами подключения API Битрикса:

\Bitrix\Main\Loader::includeModule('bxmaker.log'); 

$oLog = new \Bxmaker\Log\Manager('fname', '/podpapka/');

В итоге при первой записи появится файл fname_30.01.2016.log в папке /logs/podpapka/.
После ротации старые лог-файлы будут находится в папке - /logs/podpapka/.history/.
Помимо этого, если размер файла превышает установленный лимит размера лог-файлов, то текущий файл переименовывается в fname_30.01.2016_1.log и тп., и начинает заполняться опять файл fname_30.01.2016.log 

Какая структура лог-файлов в итоге будет?

Выполните следующий код:

\Bitrix\Main\Loader::includeModule('bxmaker.log');

$oLog = new \Bxmaker\Log\Manager('fname', '/podpapka/');

$bClear = true; // перед записью очистить файл, по умолчанию false (не очищать)
$oLog->label('== заголовок блока для удобства ========', $bClear);

$oLog->timeOn(); // добавление времени в начало строки когда она была добавлена
$oLog->setName('file2'); // изменение фнаименования файла если необходимо сменить
$oLog->setPath('/podpapka2/'); // изменение пути сохранения файла

/* записываться уже будет в другой файл так как мы сменили его выше по коду */
$oLog->label('== заголовок блока для удобства 2 ========', $bClear);
$oLog->log(array(
    'code' => array(
        'name' => 'goods-1251',
        'article' => '1298-85-895'
    ),
    'str' => true
));

$oLog->log('строка', 1);


\Bxmaker\Log\Agent::cleanLogs();

 Через некоторое время после работы модуля, структура  логов будет как на картинке:
пример структуры файлов модуля Лог операций
Содержимое лог-файлов:

файл /logs/podpapka/fanme_12.01.2016.log:

>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
== заголовок блока для удобства ========
>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>


файл /logs/podpapka2/fanme_12.01.2016.log:

>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
== заголовок блока для удобства 2 ========
>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>

16:53:50 array (
          'code' =>
          array (
            'name' => 'goods-1251',
            'article' => '1298-85-895',
          ),
        'str' => true,
        )
16:53:50 строка