Upgrading
Versioning
quiet-guard/monitor-symfony-bundle follows semantic versioning. Patch and minor releases are backward compatible; breaking changes are reserved for major versions and called out here.
The bundle depends on the framework-agnostic core quiet-guard/monitor-php, which is upgraded in lock-step. Composer resolves both together.
Compatibility
| Supported | |
|---|---|
| PHP | ^8.2 (8.2, 8.3, 8.4) |
| Symfony | 6.4 (LTS), 7.x, 8.x |
quiet-guard/monitor-php | ^0.2 |
monolog/monolog | ^3.0 (only for log forwarding) |
The Symfony components the bundle requires, symfony/config, symfony/dependency-injection, symfony/event-dispatcher and symfony/http-kernel, are constrained to ^6.4|^7.0|^8.0.
The ingestion API the bundle talks to (/api/v1/...) is platform-neutral and versioned independently of the package, so a recent bundle keeps working against a running server of the same major API version.
How to upgrade
Because configuration is declarative and environment-driven, most upgrades require no code changes, new options arrive with safe defaults and are opt-in.
Things to verify after an upgrade
- Config tree: compare your
config/packages/monitor.yamlagainst the current Configuration reference and merge any new keys. - Environments: confirm
environmentsstill matches where you want reporting active (an empty list means all environments, includingdev). - Log handler: if you forward logs, check that the
monitorhandler is still attached to Monolog and thatmonolog/monolog^3.0is installed. - Scrub list: setting
scrubreplaces the defaults, so re-check that your list still includes every key you want masked.
Removing the bundle
Then remove the bundle entry from config/bundles.php (if you registered it by hand), delete config/packages/monitor.yaml, drop any monitor handler from your Monolog config, and remove the MONITOR_* variables from your .env.
You are reading the Symfony Bundle v1.0 documentation.