[NFR]: Framework-neutral integration seam: boot and response injection without Mvc\Application
Open
@niden is already working on this.
Since Jul 22, 2026.
enhancement
- Dominant language
- PHP
- Stars
- 5
- Forks
- 3
- Avg merge
- 2d 23h
- Merged PRs (30d)
- 3
Description
Summary
The debug bar can only be booted and injected against a Phalcon\Mvc\Application. This blocks non-MVC applications - notably ADR (Phalcon\ADR) - from using it at all. Introduce a framework-neutral integration seam so any application can boot the bar and inject it into an HTML response, keeping the current MVC path as a thin wrapper.
Current coupling
Phalcon\DebugBar\Provider::__construct(Application $app, array $config)requires aPhalcon\Mvc\Application, andboot()reaches into it through$app->getDI()and$app->getEventsManager().- Response injection is attached to the MVC
application:beforeSendResponseevent insideProvider::boot()(theResponseListener).
Why it does not work for ADR
- The ADR container is
Phalcon\Container\Container(implementsCollection, notPhalcon\Di\DiInterface), sogetDI()and the?DiInterfaceparameters do not fit. - The ADR stack never fires
application:beforeSendResponse. The response is available atEvent::APPLICATION_AFTER_HANDLE(Phalcon\ADR\Application) and is written out by the ADR emitter. - Data collection (the collectors' event vocabulary) is a separate concern tracked in ticket 2; this ticket covers only the boot and injection seam.
Proposed direction
- Extract a neutral core that takes only what it needs: an events manager (or none), a
Phalcon\Http\RequestInterface(or none), and an optional config source - noPhalcon\Mvc\Application, noPhalcon\Di\DiInterface. - Provide a neutral entry point to inject the rendered bar into a given
Phalcon\Http\ResponseInterface, callable at each framework's own response-emission point:- MVC: the existing
application:beforeSendResponselistener. - ADR: a listener on
APPLICATION_AFTER_HANDLE, or an emitter hook.
- MVC: the existing
- Keep
Phalcon\DebugBar\Provider(Application $app, ...)as a thin convenience wrapper over the neutral core, so MVC behavior is unchanged.
Acceptance
- The bar boots and injects into an HTML
ResponseInterfacein an application that has neither aPhalcon\Mvc\Applicationnor aPhalcon\Di\DiInterface. - The existing MVC integration (as used by
phalcon/vokuro) is unchanged.
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Assessment
This issue has not been assessed yet.