new

mxLogger

Удобное логирование процессов в MODX Revolution

Документация

логирование miniShop2

Бесплатно

Загрузите дополнение из админки вашего сайта.
Как загрузить?

Автор дополнения

Артур Шевченко

Пакетов

Закачек

3 234

Автор дополнения

Артур Шевченко

Пакетов

Закачек

3 234

msCDEK

компонент для расчёта стоимости доставки через СДЭК

msProductDiscounts

Создание скидок на товары с широкими возможностями настройки

FlatFilters

Компонент для фильтрации любых данных.

Описание
История изменений

Версия 1.0.3-pl

Дата выпуска 19.06.2026

Загрузки 7

Просмотры 111

mxLogger — удобное логирование процессов в MODX Revolution 2.

Расставьте вызовы логгера с общими тэгами (например «purchase» и «cart») — и в менеджере найдёте все записи процесса по тэгу. В комплекте — готовый плагин, логирующий корзину и оформление заказа miniShop2, и автономный просмотрщик логов в обход MODX.

Возможности

Логирование с тэгами; у одной записи может быть несколько тэгов.
Группировка одной воронки через идентификатор процесса.
Автозахват источника вызова: класс, метод, файл, строка.
Для уровней «warning» и «error» — стэк вызовов и параметры (объекты сворачиваются в имя класса).
Автоматически пишутся пользователь, сессия, ip, время.
Фильтры записи: по пользователю, группе, сессии, куке.
Менеджерный грид с фильтрами, окном детали и кликом по значению для фильтрации.
Просмотр логов в обход MODX — CLI и WEB.

Требования к окружению

MODX Revolution 2.x (проверено на 2.8.5).
PHP 7.4 или новее.
MySQL 5.6+ / MariaDB на InnoDB — нужен FULLTEXT-индекс по тэгам.
Расширения PHP: PDO, mbstring, json.
Плагин логирования корзины/заказа работает только при установленном miniShop2.

Установка

Установите пакет через «Управление пакетами».
Создаются автоматически: таблица логов, namespace, меню «Компоненты → mxLogger», системные настройки, сниппет mxLogger и плагин mxLoggerMiniShop2.

Как добавлять логирование в свой код
После установки сервис зарегистрирован в extension_packages и доступен сразу как $modx->mxlogger — getService вызывать не нужно. Для краткости в примерах используем $mxl:

$mxl = $modx->mxlogger;

$mxl->debug('purchase', 'Открыта корзина');
$mxl->info('purchase', 'Корзина создана', ['cart_id' => $id]);
$mxl->warning('purchase', 'Низкий остаток', ['left' => 2]);
$mxl->error('purchase', 'Платёж отклонён', ['code' => 'declined']);

Несколько тэгов на одну запись:

$mxl->info(['cart', 'purchase'], 'Товар добавлен', ['product' => $pid]);

Процесс — один экземпляр воронки = один общий идентификатор:

$p = $mxl->process(['cart', 'purchase']); // идентификатор сгенерируется автоматически
$p->info('Старт оплаты', ['order' => 42]);
$p->error('Платёж отклонён', ['code' => 'declined']);
$uid = $p->getUid();                       // можно сохранить и продолжить позже

Принудительно снять полный стэк и параметры для конкретной записи:

$mxl->info('purchase', 'Создан заказ', $ctx, ['trace' => true]);

Если логируете через свою обёртку/фасад над сервисом — укажите её класс в опции skip_classes, чтобы «Источник» указывал на реальный вызывающий код, а не на обёртку (надёжнее жёсткого skip=N). Можно точное имя класса или префикс пространства имён со «\» на конце:

$mxl->info('payment', 'Платёж создан', $ctx, ['skip_classes' => ['My\\Payment\\Logger']]);

Из чанка или Fenom:

[[!mxLogger? &tags=`cart,purchase` &level=`info` &message=`Товар добавлен`]]

Тэги — только латиница и цифры в нижнем регистре, без пробелов; лишние символы вырезаются. Уровни: «debug», «info», «warning», «error».

Что пишется автоматически

Источник вызова — класс, метод, файл, строка. Движок пропускает кадры диспетчера событий, поэтому для плагинов показывает реальный метод (например msCartHandler::add), а не ~~служебный include~~.
Пользователь (id), сессия, ip, время.
Режим захвата трассировки — настройка mxlogger.capture_mode со значениями «off», «caller», «full», «auto» (по умолчанию: caller для info, full для warning и error).

Ограничение записи (фильтры)
По умолчанию пишутся все запросы. Чтобы логировать только нужную цель (отладка на проде без флуда) — задайте любую из настроек:

mxlogger.filter_user — id или username через запятую;
mxlogger.filter_usergroup — id или имя группы;
mxlogger.filter_session — идентификатор(ы) сессии;
mxlogger.filter_cookie — «имя» либо «имя=значение».

Если задан хотя бы один фильтр — запись идёт только при совпадении.

События (для уведомлений и интеграций)
При каждой записи лога вызываются два системных события — на них можно вешать плагины (например уведомления):

«mxlOnBeforeLogSave» — ДО записи. В параметры передаются все поля будущей записи (tags, level, message, context, class, function, file, line, user_id, session_id, ip, createdon) и tags_list (массив тэгов). Плагин может отменить запись или изменить любое поле.
«mxlOnAfterLogSave» — ПОСЛЕ записи. Дополнительно передаётся id сохранённой записи. Удобно для нотификаций (письмо/мессенджер при error и т.п.).

Отменить запись из обработчика «mxlOnBeforeLogSave»:

$modx->event->returnedValues['prevent'] = true;

Изменить поле (например уровень) из «mxlOnBeforeLogSave»:

$modx->event->returnedValues['level'] = 'error';

Ошибки в обработчиках событий перехватываются и не ломают ни запись лога, ни сам запрос.

Ротация (автоудаление старых логов)
Плагин mxLoggerRotate на событии OnMODXInit удаляет записи старше mxlogger.log_lifetime (по умолчанию 604800 секунд = неделя; 0 — не удалять). Реальная чистка выполняется не на каждом запросе, а не чаще раза в mxlogger.rotate_interval секунд (по умолчанию 3600 = раз в час). Удаление идёт порциями с ограничением за один проход, чтобы большой объём не нагружал сайт — остаток дочищается на следующих запусках.

Доступ к логам в обход MODX
Если MODX не загружается, логи можно смотреть скриптом по пути assets/components/mxlogger/standalone.php — он не запускает MODX, а читает таблицу напрямую через PDO (параметры БД берёт из core/config/config.inc.php).

CLI — по SSH, без ключа. Запускайте интерпретатором PHP 7.4, например:

php assets/components/mxlogger/standalone.php limit=20

Параметры (одинаковы для CLI и WEB): tag, level, process, ident, q, since, until, limit, id, full, color. Примеры:

tag=cart — по тэгу;
level=error — по уровню;
process=ms_xxxx — вся воронка процесса;
ident=admin — по пользователю, сессии или ip;
q=текст — поиск по сообщению, источнику, файлу;
since=«2026-06-01 10:00» и until=«2026-06-01 18:00» — диапазон дат;
limit=50 — число строк (по умолчанию 100, максимум 2000);
id=255 — показать одну запись целиком (context и trace);
full=1 — не усекать context/trace; color=1 или color=0 — форс цвета.

Список выводится таблицей. Чтобы развернуть запись — возьмите её номер из колонки ID и добавьте параметр id с этим номером.

WEB — нужен ключ, иначе 403. Откройте в браузере адрес скрипта с параметром key и, при необходимости, фильтрами, например: …/assets/components/mxlogger/standalone.php?key=ВАШ_КЛЮЧ&tag=cart&level=error

Как создать ключ для веб-доступа
Веб-просмотрщик закрыт, пока не задан ключ. Задайте его одним из способов:

Файлом: создайте файл по пути core/components/mxlogger/standalone.key и впишите одну строку — ваш секрет. Сгенерировать секрет можно командой:
```
openssl rand -hex 20
```
Каталог core не отдаётся вебом, поэтому ключ снаружи не прочитать.
Переменной окружения MXLOGGER_TOKEN — предпочтительнее, ключ не светится в URL и логах сервера.

После этого открывайте адрес скрипта с параметром key. Чтобы выключить веб-доступ — удалите файл ключа (CLI продолжит работать). Чтобы сменить ключ — перезапишите файл новым значением.

Ссылка с ключом = доступ к логам (там сессии, ip, контекст). Не публикуйте её и передавайте только по защищённым каналам.

Если повреждён и сам файл core/config/config.inc.php — параметры БД можно задать переменными окружения MXLOGGER_DSN, MXLOGGER_DB_USER, MXLOGGER_DB_PASS, MXLOGGER_TABLE_PREFIX.

Системные настройки

mxlogger.enabled — глобальный выключатель записи;
mxlogger.min_level — минимальный уровень;
mxlogger.capture_mode, mxlogger.trace_limit, mxlogger.args_max_depth, mxlogger.args_max_string, mxlogger.args_max_items — захват трассировки;
mxlogger.tag_filter_mode — значения «auto», «fulltext», «like»;
mxlogger.log_lifetime — срок хранения в секундах (0 — не удалять).

Полезные ссылки

Лицензия — GNU GPL v2 или новее.

mxLogger 1.0.3-pl (2026-06-19)

Manager UI переведён на пакет VueTools: Vue/Pinia/PrimeVue/тема/иконки берутся из общего Import Map VueTools, а не бандлятся в каждый пакет. Бандл logs.min.js теперь содержит только код приложения (вес пакета упал в разы).
Новая зависимость: требуется установленный VueTools. При его отсутствии вместо ошибок «Failed to resolve module» показывается понятный алерт (лексемы mxlogger_error / mxlogger_vuetools_required).
Импорты PrimeVue переведены на именованные из бандла 'primevue'; контейнер приложения помечен class="vueApp" для изоляции стилей PrimeVue от ExtJS.
Тема — штатная Aura из VueTools (отказались от собственного preset).

mxLogger 1.0.2-pl (2026-06-19)

Селектор тэгов (PrimeVue MultiSelect): высота панели ограничена ~10 строками с виртуальным скроллом + встроенный поиск по тэгам (filterPlaceholder «Поиск по тэгам»). Решает проблему слишком длинного списка при большом числе источников/пакетов. Порт фичи из версии под MODX 2 (там — пагинация по 10).
Пересобран Vue-бандл (vue-dist).

mxLogger 1.0.1-pl (2026-06-17)

Очистка журнала теперь уважает ВСЕ активные фильтры грида. В процессоре Clear отбрасывались фильтры «Пользователь/сессия/IP» (ident) и «Поиск по тексту» (query) — удалялось больше, чем показано в гриде. Vue-фронт уже передавал их корректно; исправлен бэкенд.
Условия фильтрации вынесены в общий построитель MxLogger\Helpers\LogFilters — единый источник правды для выборки (GetList) и очистки (Clear), чтобы они не расходились.

mxLogger 1.0.0-pl (2026-06-17)

Порт mxLogger с MODX 2 на MODX 3 (xPDO 3, PHP 8.1+). Перенесён весь функционал двойки.

Ядро (сервис и модель):

Сервис-классы MxLogger\MxLogger и MxLogger\MxLoggerProcess (PSR-4, namespaced): log/debug/info/warning/error, скоуп процесса process() с общим process_uid.
Доступ к сервису через DI-контейнер: $modx->services->get('mxlogger') (замена extension_packages из двойки). bootstrap.php регистрирует сервис и xPDO-пакет модели MxLogger\Model.
Модель MxLoggerLog (xPDO 3, schema version 3.0): tags, process_uid, level, message, context(JSON), class, function, file, line, trace(JSON), user_id, session_id, ip, createdon. Мультитэги — CSV-колонка tags с FULLTEXT-индексом; фильтр any/all, режим mxlogger.tag_filter_mode (auto/fulltext/like).
Автозахват «Источника» (class/function/file/line) и стэка с параметрами; объекты сворачиваются в object(Класс). Диспетчерские кадры фреймворка пропускаются — в т.ч. namespaced MODX 3 (MODX\Revolution\modScript::process, *::invokeEvent, include/eval) — поэтому источник указывает на реальный код.
Опция skip_classes (классы-прокладки фасадов над логгером), whitelist-фильтры записи (пользователь/группа/сессия/кука), события mxlOnBeforeLogSave / mxlOnAfterLogSave.
Резолвер таблицы приводит mxlogger_log к utf8mb4 с порога (иначе кириллица падала бы с «1366 Incorrect string value»).

Менеджерный интерфейс (CMP):

Грид логов переписан на Vue 3 + PrimeVue 4 (тема Aura, styled-mode) + Vite (вместо ExtJS двойки). Фильтры по тэгу (мультиселект с чекбоксами), уровню, процессу, пользователю/сессии/IP, периоду, тексту — применяются автоматически. Двойной клик по строке открывает окно детали (таблица полей + клик по значению заполняет фильтр; контекст и стэк — во вкладках). Очистка журнала по фильтру.
Контроллер страницы — core/components/mxlogger/controllers/logs.class.php (файловый механизм MODX 3: ucfirst(namespace).action.'ManagerController').
Процессоры MxLogger\Processors\Mgr\Log{GetList,Get,GetTags,Clear,Remove}, коннектор assets/.../connector.php (action = FQCN процессора).

Сниппет, плагины, break-glass:

Сниппет mxLogger — запись лога из чанка/Fenom.
Плагин mxLoggerRotate (OnMODXInit) — ротация старых записей по mxlogger.log_lifetime.
Плагин mxLoggerMiniShop3 (static) — логирование событий miniShop3: корзина (тэг cart), заказ (тэг order), сквозной purchase, воронка по сессии. Параметры событий ms3 (product_key, msOrder и т.п.) читаются из $modx->event->params. Аргументы метода в trace не пишутся (trace=caller) — чтобы не утекали ПДн/токен заказа при capture_mode=full. ms3 трактует непустой возврат плагина как ошибку — плагин всегда возвращает пусто. Требует установленного miniShop3.
standalone.php — просмотр логов в обход MODX (CLI всегда; web по ключу), читает БД напрямую через PDO. Имена колонок в SELECT забэктикованы (MariaDB строга к function/line).