Начало работы

ADP (Application Development Panel) — это фреймворк-независимая панель отладки для PHP-приложений. Она собирает данные во время выполнения и предоставляет веб-интерфейс для их анализа.

Требования

• PHP 8.4 или выше
• Composer

Установка

1. Установите адаптер для вашего фреймворка

composer require app-dev-panel/adapter-symfony

Каждый адаптер автоматически подтягивает app-dev-panel/kernelapp-dev-panel/kernelView on Packagist и app-dev-panel/apiapp-dev-panel/apiView on Packagist как зависимости.

2. Сконфигурируйте приложение

// config/bundles.php
return [
    // ...
    AppDevPanel\Adapter\Symfony\AppDevPanelBundle::class => ['dev' => true, 'test' => true],
];

3. Начинайте отладку

Запустите приложение и откройте http://your-app/debug в браузере. Панель отладки ADP покажет данные отладки, собранные из вашего приложения в реальном времени.

Встроенный сервер PHP

При использовании встроенного сервера PHP всегда устанавливайте PHP_CLI_SERVER_WORKERS=3 или выше. ADP выполняет параллельные запросы (SSE + получение данных); однопоточный режим вызывает таймауты.

PHP_CLI_SERVER_WORKERS=3 php -S 127.0.0.1:8080 -t public

Попробуйте демо

Попробуйте UI панели прямо сейчас с Live Demo — установка не требуется. Введите URL бэкенда вашего приложения для подключения.

ADP также поставляется с playground-приложениями для каждого поддерживаемого фреймворка:

git clone https://github.com/app-dev-panel/app-dev-panel.git
cd app-dev-panel
make install              # Установить все зависимости

Запустите playground-сервер:

cd playground/symfony-app && PHP_CLI_SERVER_WORKERS=3 php -S 127.0.0.1:8102 -t public

Обзор архитектуры

ADP использует многослойную архитектуру:

┌──────────────┐     ┌──────────────┐     ┌──────────────┐
│   Frontend   │────▶│     API      │────▶│    Kernel     │
│  (React SPA) │ HTTP│  (REST+SSE)  │     │ (Collectors)  │
└──────────────┘     └──────────────┘     └───────┬───────┘
                                                  │
                                          ┌───────┴───────┐
                                          │    Adapter     │
                                          └───────┬───────┘
                                                  │
                                          ┌───────┴───────┐
                                          │  Target App   │
                                          └───────────────┘

1. Kernel — Ядро, управляющее жизненным циклом отладчика, коллекторами и хранилищем
2. API — HTTP-слой, предоставляющий данные отладки через REST + SSE
3. Adapter — Мост к фреймворку, подключающий коллекторы к вашему приложению
4. Frontend — React SPA, использующий API

Что дальше?

• Что такое ADP? — Философия проекта
• Панель отладки — Настройка встроенной панели отладки
• Архитектура — Глубокое погружение в дизайн системы
• Коллекторы — Как собираются данные
• Поток данных — Путь данных от приложения до панели
• Матрица возможностей — Что поддерживается в каждом фреймворке
• Playground-приложения — Попробуйте демо-приложения