Матрица возможностей

ADP поддерживает несколько PHP-фреймворков через адаптеры. Каждый адаптер подключает хуки фреймворка к общим коллекторам Kernel. На этой странице описано, что доступно в каждом адаптере.

Поддержка коллекторов по адаптерам

Все коллекторы находятся в Kernel и не зависят от фреймворка. Адаптеры регистрируют и подключают их через хуки событий, прокси или декораторы.

Универсальные коллекторы

Эти коллекторы зарегистрированы во всех пяти полных адаптерах:

Коллектор	Панель	Описание
TimelineCollectorAppDevPanel\Kernel\Collector\TimelineCollectorCollects Timeline data during application lifecycle.final Kernel · class · implements SummaryCollectorInterface	Timeline	События временной шкалы производительности
LogCollectorAppDevPanel\Kernel\Collector\LogCollectorCollects Log data during application lifecycle.Kernel · class · implements SummaryCollectorInterface	Logs	PSR-3 сообщения логов
EventCollectorAppDevPanel\Kernel\Collector\EventCollectorCollects Event data during application lifecycle.final Kernel · class · implements SummaryCollectorInterface	Events	PSR-14 отправленные события
ExceptionCollectorAppDevPanel\Kernel\Collector\ExceptionCollectorCollects Exception data during application lifecycle.final Kernel · class · implements SummaryCollectorInterface	Exceptions	Необработанные исключения со стек-трейсами
DeprecationCollectorAppDevPanel\Kernel\Collector\DeprecationCollectorCollects Deprecation data during application lifecycle.final Kernel · class · implements SummaryCollectorInterface	(в Logs)	PHP deprecation-предупреждения
ServiceCollectorAppDevPanel\Kernel\Collector\ServiceCollectorCollects Service data during application lifecycle.final Kernel · class · implements SummaryCollectorInterface	Services	Разрешения сервисов DI-контейнера
HttpClientCollectorAppDevPanel\Kernel\Collector\HttpClientCollectorCollects Http Client data during application lifecycle.final Kernel · class · implements SummaryCollectorInterface	HTTP Client	PSR-18 исходящие HTTP-запросы
VarDumperCollectorAppDevPanel\Kernel\Collector\VarDumperCollectorCollects Var Dumper data during application lifecycle.final Kernel · class · implements SummaryCollectorInterface	Var Dumper	Вызовы dump() / dd()
EnvironmentCollectorAppDevPanel\Kernel\Collector\EnvironmentCollectorCollects runtime environment information: PHP version, extensions, SAPI, OS, working directory, server parameters, and environment variables.final Kernel · class · implements SummaryCollectorInterface	Environment	Информация о PHP и ОС
FilesystemStreamCollectorAppDevPanel\Kernel\Collector\Stream\FilesystemStreamCollectorCollects Filesystem Stream data during application lifecycle.final Kernel · class · implements SummaryCollectorInterface	Filesystem	Операции файловых потоков
HttpStreamCollectorAppDevPanel\Kernel\Collector\Stream\HttpStreamCollectorCollects Http Stream data during application lifecycle.final Kernel · class · implements SummaryCollectorInterface	(скрыт)	Сырые HTTP-потоки (подвид HTTP Client)
RequestCollectorAppDevPanel\Kernel\Collector\Web\RequestCollectorCollects Request data during application lifecycle.final Kernel · class · implements SummaryCollectorInterface	Request	Входящие HTTP запрос/ответ (web-записи)
CommandCollectorAppDevPanel\Kernel\Collector\Console\CommandCollectorCollects Command data during application lifecycle.final Kernel · class · implements SummaryCollectorInterface	Request	Детали консольной команды (console-записи)
WebAppInfoCollectorAppDevPanel\Kernel\Collector\Web\WebAppInfoCollectorCollects Web App Info data during application lifecycle.final Kernel · class · implements SummaryCollectorInterface	(мета)	Сводка web-приложения для списка записей
ConsoleAppInfoCollectorAppDevPanel\Kernel\Collector\Console\ConsoleAppInfoCollectorCollects Console App Info data during application lifecycle.final Kernel · class · implements SummaryCollectorInterface	(мета)	Сводка консольного приложения для списка записей
RouterCollectorAppDevPanel\Kernel\Collector\RouterCollectorCaptures HTTP routing data: matched route, match timing, route tree.final Kernel · class · implements SummaryCollectorInterface	Router	Данные маршрутизации HTTP
ValidatorCollectorAppDevPanel\Kernel\Collector\ValidatorCollectorCaptures validation operations with results.final Kernel · class · implements SummaryCollectorInterface	Validator	Операции валидации и результаты
TranslatorCollectorAppDevPanel\Kernel\Collector\TranslatorCollectorCaptures translation lookups during request execution.final Kernel · class · implements SummaryCollectorInterface	Translator	Поиск переводов, пропущенные переводы
AuthorizationCollectorAppDevPanel\Kernel\Collector\AuthorizationCollectorCaptures authentication and authorization data.final Kernel · class · implements SummaryCollectorInterface	Security	Данные аутентификации и авторизации
OpenTelemetryCollectorAppDevPanel\Kernel\Collector\OpenTelemetryCollectorCollects Open Telemetry data during application lifecycle.final Kernel · class · implements SummaryCollectorInterface	OpenTelemetry	OpenTelemetry span-ы и трейсы

Матрица доступности коллекторов

Коллектор	Yii 3	Symfony	Laravel	Yii2	Spiral	Панель
Database	✅	✅	✅	✅	—	Database
Cache	✅	✅	✅	✅	✅	Cache
Mailer	✅	✅	✅	✅	✅	Mailer
Queue	✅	✅	✅	✅	✅	Queue
Redis	✅	✅	✅	✅	—	Redis
Elasticsearch	✅	✅	✅	✅	—	Elasticsearch
View	✅	—	—	✅	—	WebView
Templates	—	✅	✅	✅	✅	Templates
Code Coverage	✅	✅	✅	✅	—	Coverage
Asset Bundles	✅	✅	✅	✅	—	Asset Bundles
Middleware	✅	—	—	—	—	Middleware
Messenger	—	✅	—	—	—	Messenger

Spiral — авто-подключение

Адаптер Spiral подключает каждый коллектор через Container/*ProxyInjector (см. Инжекторы контейнера) — коллекторы кеша, mailer, queue, переводчика и шаблонов наполняются автоматически, как только в приложении установлен соответствующий пакет spiral/*. Никаких ручных вызовов collect() не требуется.

Итого коллекторов по адаптерам

Адаптер	Универсальные	Дополнительные	Всего
Yii 3	20	10	30
Symfony	20	10	30
Yii2	20	10	30
Laravel	20	10	30
Spiral	20	4	24

Механизмы проксирования / перехвата

Каждый адаптер использует разные стратегии для перехвата внутренних механизмов фреймворка и передачи данных в коллекторы:

Интерфейс	Yii 3	Symfony	Laravel	Yii2	Spiral
PSR-3 Logger	LoggerInterfaceProxyAppDevPanel\Kernel\Collector\LoggerInterfaceProxyDecorator proxy for Logger Interface. Intercepts calls and forwards data to collectors.final Kernel · class · implements LoggerInterface	LoggerInterfaceProxyAppDevPanel\Kernel\Collector\LoggerInterfaceProxyDecorator proxy for Logger Interface. Intercepts calls and forwards data to collectors.final Kernel · class · implements LoggerInterface	LoggerInterfaceProxyAppDevPanel\Kernel\Collector\LoggerInterfaceProxyDecorator proxy for Logger Interface. Intercepts calls and forwards data to collectors.final Kernel · class · implements LoggerInterface	DebugLogTargetAppDevPanel\Adapter\Yii2\Collector\DebugLogTargetReal-time log target that feeds Yii 2 log messages to ADP's LogCollector.final Adapter/Yii2 · class · extends Target	LoggerProxyInjectorAppDevPanel\Adapter\Spiral\Container\LoggerProxyInjector
PSR-14 Events	EventDispatcherInterfaceProxyAppDevPanel\Kernel\Collector\EventDispatcherInterfaceProxyDecorator proxy for Event Dispatcher Interface. Intercepts calls and forwards data to collectors.final Kernel · class · implements EventDispatcherInterface	SymfonyEventDispatcherProxyAppDevPanel\Adapter\Symfony\Proxy\SymfonyEventDispatcherProxyWraps Symfony's event dispatcher to intercept dispatched events.final Adapter/Symfony · class · implements EventDispatcherInterface	LaravelEventDispatcherProxyAppDevPanel\Adapter\Laravel\Proxy\LaravelEventDispatcherProxyWraps Laravel's event dispatcher to intercept dispatched events.final Adapter/Laravel · class · implements Dispatcher	Wildcard Event::on('*')	EventDispatcherProxyInjectorAppDevPanel\Adapter\Spiral\Container\EventDispatcherProxyInjector
PSR-18 HTTP Client	HttpClientInterfaceProxyAppDevPanel\Kernel\Collector\HttpClientInterfaceProxyDecorator proxy for Http Client Interface. Intercepts calls and forwards data to collectors.final Kernel · class · implements ClientInterface	HttpClientInterfaceProxyAppDevPanel\Kernel\Collector\HttpClientInterfaceProxyDecorator proxy for Http Client Interface. Intercepts calls and forwards data to collectors.final Kernel · class · implements ClientInterface	HttpClientInterfaceProxyAppDevPanel\Kernel\Collector\HttpClientInterfaceProxyDecorator proxy for Http Client Interface. Intercepts calls and forwards data to collectors.final Kernel · class · implements ClientInterface	HttpClientInterfaceProxyAppDevPanel\Kernel\Collector\HttpClientInterfaceProxyDecorator proxy for Http Client Interface. Intercepts calls and forwards data to collectors.final Kernel · class · implements ClientInterface	HttpClientProxyInjectorAppDevPanel\Adapter\Spiral\Container\HttpClientProxyInjector
PSR-11 Container	ContainerInterfaceProxyAppDevPanel\Adapter\Yii3\Proxy\ContainerInterfaceProxyDecorator proxy for Container Interface. Intercepts calls and forwards data to collectors.final Adapter/Yii3 · class · implements ContainerInterface	Compiler pass	—	—	—
VarDumper	VarDumperHandlerInterfaceProxyAppDevPanel\Adapter\Yii3\Proxy\VarDumperHandlerInterfaceProxyDecorator proxy for Var Dumper Handler Interface. Intercepts calls and forwards data to collectors.final Adapter/Yii3 · class · implements HandlerInterface	Handler hook	Handler hook	Handler hook	Handler hook
Database	ConnectionInterfaceProxyAppDevPanel\Adapter\Yii3\Collector\Db\ConnectionInterfaceProxyDecorator proxy for Connection Interface. Intercepts calls and forwards data to collectors.final Adapter/Yii3 · class · implements ConnectionInterface	DBAL middleware	Event listener	DbProfilingTargetAppDevPanel\Adapter\Yii2\Collector\DbProfilingTargetYii 2 profiling target that captures database query timing and feeds it to DbCollector.final Adapter/Yii2 · class · extends Target	—
Mailer	MailerInterfaceProxyAppDevPanel\Adapter\Yii3\Collector\Mailer\MailerInterfaceProxyDecorator proxy for Mailer Interface. Intercepts calls and forwards data to collectors.final Adapter/Yii3 · class · implements MailerInterface	Event listener	Event listener	Event hook	MailerProxyInjectorAppDevPanel\Adapter\Spiral\Container\MailerProxyInjector
Router	UrlMatcherInterfaceProxyAppDevPanel\Adapter\Yii3\Collector\Router\UrlMatcherInterfaceProxyDecorator proxy for Url Matcher Interface. Intercepts calls and forwards data to collectors.final Adapter/Yii3 · class · implements UrlMatcherInterface	—	RouterDataExtractorAppDevPanel\Adapter\Laravel\Collector\RouterDataExtractorExtracts route data from Laravel's router and feeds it to the Kernel RouterCollector.final Adapter/Laravel · class	UrlRuleProxyAppDevPanel\Adapter\Yii2\Proxy\UrlRuleProxyWraps a Yii 2 URL rule to intercept successful route matching.final Adapter/Yii2 · class · implements UrlRuleInterface	SpiralRouteCollectionAdapterAppDevPanel\Adapter\Spiral\Inspector\SpiralRouteCollectionAdapter + DebugRouteInterceptorAppDevPanel\Adapter\Spiral\Interceptor\DebugRouteInterceptor
Validator	ValidatorInterfaceProxyAppDevPanel\Adapter\Yii3\Collector\Validator\ValidatorInterfaceProxyDecorator proxy for Validator Interface. Intercepts calls and forwards data to collectors.final Adapter/Yii3 · class · implements ValidatorInterface	—	—	—	—
Queue (push)	QueueProviderInterfaceProxyAppDevPanel\Adapter\Yii3\Collector\Queue\QueueProviderInterfaceProxyDecorator proxy for Queue Provider Interface. Intercepts calls and forwards data to collectors.final Adapter/Yii3 · class · implements QueueProviderInterface	—	Event listener	—	QueueProxyInjectorAppDevPanel\Adapter\Spiral\Container\QueueProxyInjector
Queue (consume)	—	—	Event listener	—	DebugQueueInterceptorAppDevPanel\Adapter\Spiral\Interceptor\DebugQueueInterceptor
Консольные команды	—	События ядра	События ядра	События консоли	DebugConsoleInterceptorAppDevPanel\Adapter\Spiral\Interceptor\DebugConsoleInterceptor
View/Templates	—	Twig profiler extension	TemplateCollectorCompilerEngineAppDevPanel\Adapter\Laravel\Collector\TemplateCollectorCompilerEngine	View::EVENT_AFTER_RENDER	ViewsProxyInjectorAppDevPanel\Adapter\Spiral\Container\ViewsProxyInjector
Cache	—	Decorated CacheAdapter	Event listener	—	CacheProxyInjectorAppDevPanel\Adapter\Spiral\Container\CacheProxyInjector
Messenger	—	Messenger middleware	—	—	—
Asset Bundles	AssetLoaderInterfaceProxyAppDevPanel\Adapter\Yii3\Collector\Asset\AssetLoaderInterfaceProxy	AssetMapperSubscriberAppDevPanel\Adapter\Symfony\EventSubscriber\AssetMapperSubscriber	ViteAssetListenerAppDevPanel\Adapter\Laravel\EventListener\ViteAssetListener	View::EVENT_END_PAGE	—
OpenTelemetry	SpanProcessorInterfaceProxyAppDevPanel\Kernel\Collector\SpanProcessorInterfaceProxyDecorates an OpenTelemetry SpanProcessorInterface to capture span data into the OpenTelemetryCollector without altering telemetry pipeline behaviour.final Kernel · class · implements SpanProcessorInterface	SpanProcessorInterfaceProxyAppDevPanel\Kernel\Collector\SpanProcessorInterfaceProxyDecorates an OpenTelemetry SpanProcessorInterface to capture span data into the OpenTelemetryCollector without altering telemetry pipeline behaviour.final Kernel · class · implements SpanProcessorInterface	SpanProcessorInterfaceProxyAppDevPanel\Kernel\Collector\SpanProcessorInterfaceProxyDecorates an OpenTelemetry SpanProcessorInterface to capture span data into the OpenTelemetryCollector without altering telemetry pipeline behaviour.final Kernel · class · implements SpanProcessorInterface	SpanProcessorInterfaceProxyAppDevPanel\Kernel\Collector\SpanProcessorInterfaceProxyDecorates an OpenTelemetry SpanProcessorInterface to capture span data into the OpenTelemetryCollector without altering telemetry pipeline behaviour.final Kernel · class · implements SpanProcessorInterface	—
Translator	TranslatorInterfaceProxyAppDevPanel\Adapter\Yii3\Collector\Translator\TranslatorInterfaceProxyDecorates Yiisoft TranslatorInterface to feed translation lookups to TranslatorCollector.final Adapter/Yii3 · class · implements TranslatorInterface	SymfonyTranslatorProxyAppDevPanel\Adapter\Symfony\Proxy\SymfonyTranslatorProxyDecorates Symfony's TranslatorInterface to feed translation lookups to TranslatorCollector.final Adapter/Symfony · class · implements TranslatorInterface	LaravelTranslatorProxyAppDevPanel\Adapter\Laravel\Proxy\LaravelTranslatorProxyDecorates Laravel's Translator to feed translation lookups to TranslatorCollector.final Adapter/Laravel · class · implements Translator	I18NProxyAppDevPanel\Adapter\Yii2\Proxy\I18NProxyDecorates Yii 2's I18N component to feed translation lookups to TranslatorCollector.final Adapter/Yii2 · class · extends I18N	TranslatorProxyInjectorAppDevPanel\Adapter\Spiral\Container\TranslatorProxyInjector

Возможности инспектора

Инспектор предоставляет интроспекцию приложения в реальном времени (не привязана к записям отладки). Все API-функции не зависят от адаптера:

Возможность	Yii 3	Symfony	Laravel	Yii2	Cycle
Конфигурация	✅	✅	✅	✅	—
Схема БД	✅	✅	✅	✅	✅
Маршруты	✅	✅	✅	✅	—
Файловый проводник	✅	✅	✅	✅	—
Git	✅	✅	✅	✅	—
Composer	✅	✅	✅	✅	—
Opcache	✅	✅	✅	✅	—
PHP Info	✅	✅	✅	✅	—
Команды	✅	✅	✅	✅	—
Container / DI	✅	✅	✅	✅	—
Кеш	✅	✅	✅	✅	—
Переводы	✅	✅	✅	✅	—

Различия в возможностях адаптеров

Текущие различия между адаптерами:

Возможность	Yii 3	Symfony	Laravel	Yii2
Отладка шаблонов	✅	✅	✅	✅
Code coverage	✅	✅	✅	✅
Отладка asset bundles	✅	✅	✅	✅
Отладка middleware	✅	❌	❌	❌
Отладка шины сообщений	❌	✅	❌	❌
Прокси контейнера	✅	❌	❌	❌

TIP

Паритет возможностей активно улучшается. Если вам нужен определённый коллектор для вашего фреймворка, участие в разработке приветствуется.