Коллектор базы данных

Захватывает SQL-запросы, параметры, время выполнения, транзакции и обнаружение дублирующихся запросов.

Собираемые данные

Поле	Описание
sql	SQL-запрос с плейсхолдерами параметров
rawSql	SQL-запрос с подставленными параметрами
params	Массив привязанных параметров
line	Файл и строка исходного кода вызова запроса
status	Статус запроса (success или error)
rowsNumber	Количество затронутых/возвращённых строк
exception	Исключение в случае ошибки запроса
transactionId	Идентификатор связанной транзакции

Схема данных

{
    "queries": [
        {
            "position": 0,
            "transactionId": null,
            "sql": "SELECT * FROM users WHERE id = :id",
            "rawSql": "SELECT * FROM users WHERE id = 42",
            "params": {":id": 42},
            "line": "/app/src/UserRepository.php:35",
            "status": "success",
            "rowsNumber": 1,
            "exception": null,
            "actions": []
        }
    ],
    "transactions": {},
    "duplicates": {
        "groups": [],
        "totalDuplicatedCount": 0
    }
}

Сводка (отображается в списке отладочных записей):

{
    "db": {
        "queries": {"error": 0, "total": 3},
        "transactions": {"error": 0, "total": 1},
        "duplicateGroups": 0,
        "totalDuplicatedCount": 0
    }
}

Контракт

Жизненный цикл запроса

use AppDevPanel\Kernel\Collector\DatabaseCollector;

// Option A: start/end pattern
$collector->collectQueryStart(
    id: 'query-1',
    sql: 'SELECT * FROM users WHERE id = :id',
    rawSql: 'SELECT * FROM users WHERE id = 42',
    params: [':id' => 42],
    line: '/app/src/UserRepository.php:35',
);
$collector->collectQueryEnd(id: 'query-1', rowsNumber: 1);

// Option B: single record
use AppDevPanel\Kernel\Collector\QueryRecord;

$collector->logQuery(new QueryRecord(
    sql: 'SELECT * FROM users WHERE id = :id',
    rawSql: 'SELECT * FROM users WHERE id = 42',
    params: [':id' => 42],
    duration: 0.0023,
    line: '/app/src/UserRepository.php:35',
));

Транзакции

$collector->collectTransactionStart(isolationLevel: 'READ COMMITTED', line: '...');
$collector->collectTransactionEnd(status: 'commit', line: '...');

INFO

DatabaseCollectorAppDevPanel\Kernel\Collector\DatabaseCollectorCaptures SQL queries and transactions from the application.final Kernel · class · implements SummaryCollectorInterface реализует SummaryCollectorInterfaceAppDevPanel\Kernel\Collector\SummaryCollectorInterfaceSummary data collector responsibility is to collect summary data for a collector. Summary is used to display a list of previous requests and select one to display full info. Its data set is specific to the list and is reduced compared to full data collected in {@see CollectorInterface}.Kernel · interface · extends CollectorInterface, зависит от TimelineCollectorAppDevPanel\Kernel\Collector\TimelineCollectorCollects Timeline data during application lifecycle.final Kernel · class · implements SummaryCollectorInterface и использует DuplicateDetectionTraitAppDevPanel\Kernel\Collector\DuplicateDetectionTraitDetects duplicate items in collector data by grouping them by a key.Kernel · trait для обнаружения повторяющихся запросов.

Как это работает

Адаптеры фреймворков перехватывают операции с базой данных через специфичные для фреймворка хуки:

• Symfony: middleware Doctrine DBAL
• Laravel: слушатель DB-запросов
• Yii 2: лог-таргет для сообщений профилирования БД
• Yii 3: слушатели событий запросов

Панель отладки

• Количество запросов и общее время — заголовок сводки с агрегированной статистикой
• Подсветка синтаксиса SQL — запросы отображаются с цветовым выделением ключевых слов
• Бейджи типов запросов — SELECT, INSERT, UPDATE, DELETE с цветовой кодировкой
• Количество строк и время — метрики выполнения для каждого запроса
• План выполнения (Explain) — визуальное дерево EXPLAIN для SELECT-запросов
• Обнаружение дубликатов — подсветка повторяющихся идентичных запросов
• Группировка по транзакциям — запросы сгруппированы по границам транзакций