A framework-agnostic PHP core providing snapshots, storage, and the complete frontend for debugger adapters.
Install an adapter, not this package. Debug Core is pulled in transitively:
If you develop an adapter:
composer require php-forge/debug-core:^0.1PHP 8.3 or later and the ctype, intl, and mbstring extensions are required.
The core owns snapshot capture, persistence, comparison, and the shared UI. A framework adapter remains responsible for:
- collecting framework data through
PHPForge\Debug\CollectorInterface, the single collector contract shared with provider-owned collectors, and returning the persisted payload fromcapture(); - exposing the toolbar data endpoints and deciding when a response receives the toolbar;
- defining and publishing assets through its own framework;
- rendering the shared templates with its view component;
- routes, controllers, URL generation, panel metadata, and framework-specific panel views;
- implementing
Routing\DebugUrlGeneratorInterfaceso portable renderers build panel links without a framework URL manager.
The adapter-facing API is documented in the source PHPDoc under src/.
The frontend source lives in resources/src and Vite builds it into resources/assets/dist. Two entries are built:
resources/src/toolbar/index.js— the<yii-debug-toolbar>custom element.element.jsowns the view state, the shadow skeleton, and the render cycle; it composes one controller per responsibility (loader.js,theme-controller.js,drawer.js) and renders through the stateless builders inrender.js.resources/src/core/debug.js— the debugger page bootstrap. It resolves the theme, initializes the page controllers (theme.js,disclosure.js,live-filter.js,grid-navigation.js,tabs.js,deep-links.js,clipboard.js,features.js), and owns the keyboard precedence between the layers.
Rebuild and verify with:
npm install
npm run format:check
npm run lint:js
npm run lint:css
npm run test:js
npm run build
npm run check:size
npm run check:iconscheck:icons compares the toolbar's inline glyphs with resources/assets/svg; the toolbar-only chrome glyphs
(chevron-left, chevron-right, close, external-link) have no panel file by design and never fail --strict.
This package has no separate guides; its documentation topics live in this README and the source PHPDoc.
AI agents: read the documentation index and fetch the Markdown version
of a page by appending index.md to its URL. The
AI agents guide covers skill
installation, client setup and verification.
- 🤖
php-forge-debug-coreskill: building a debugger adapter on the core, with snapshot storage and read diagnostics, log context redaction, the routing contract and the toolbar frontend sources.
See the repository guides, the skill source, the source PHPDoc and the changelog.