PHPackages cdn77/tracy-blue-screen-bundle - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Debugging & Profiling](/categories/debugging) 4. / 5. cdn77/tracy-blue-screen-bundle ActiveLibrary[Debugging & Profiling](/categories/debugging) cdn77/tracy-blue-screen-bundle ============================== This bundle lets you use the Tracy's debug screen in combination with the the default profiler in your Symfony application. 1.0.4(5mo ago)395.6k—3.1%1[1 issues](https://github.com/cdn77/Tracy-Blue-Screen-Bundle/issues)MITPHPPHP ^8.3CI passing Since Jan 27Pushed 2mo agoCompare [ Source](https://github.com/cdn77/Tracy-Blue-Screen-Bundle)[ Packagist](https://packagist.org/packages/cdn77/tracy-blue-screen-bundle)[ RSS](/packages/cdn77-tracy-blue-screen-bundle/feed)WikiDiscussions master Synced 1mo ago READMEChangelog (10)Dependencies (14)Versions (15)Used By (0) Tracy BlueScreen Bundle ======================= [](#tracy-bluescreen-bundle) [![GitHub Actions](https://github.com/cdn77/Tracy-Blue-Screen-Bundle/workflows/CI/badge.svg)](https://github.com/cdn77/Tracy-Blue-Screen-Bundle/actions?query=workflow%3A%22CI%22+branch%3Amaster)[![Code Coverage](https://camo.githubusercontent.com/96866233606570cbeeba400cc6a3239ebcd58db403d8672995d15e197052ed4e/68747470733a2f2f636f6465636f762e696f2f67682f63646e37372f54726163792d426c75652d53637265656e2d42756e646c652f6272616e63682f6d61737465722f67726170682f62616467652e737667)](https://codecov.io/gh/cdn77/Tracy-Blue-Screen-Bundle/branch/master) **This bundle lets you use the [Tracy's debug screen](https://github.com/nette/tracy#visualization-of-errors-and-exceptions) in combination with the the default profiler in your Symfony application.** Why is Tracy's debug screen better than the Symfony default exception screen: - You can browse all values of function call arguments. - All information about the current request and environment. - You can view all the information which is contained by the exception (e.g. private properties). - Configurable links to files in stacktrace which can open directly in the IDE. - Fullscreen layout providing more space for information. - Look at the interactive [example screen](http://nette.github.io/tracy/tracy-exception.html). However, the Symfony profiler provides a lot of useful information about the application when an error occurs, so it is better to have them both available: [![Nette Tracy with Symfony profiler screenshot](docs/tracy-with-profiler.png)](docs/tracy-with-profiler.png) ### Console integration [](#console-integration) To provide the same comfort while using [Symfony Console](http://symfony.com/doc/current/components/console/introduction.html) this bundle will save a rendered BlueScreen to a file and show you a link for it. If you configure it, it will open the exception directly in your browser. [![Link to generated BlueScreen in Console](docs/tracy-in-console.png)](docs/tracy-in-console.png) Usage ----- [](#usage) If you do not have any custom `kernel.exception` listeners this works out of the box. However, if you have any, you have to ensure that they do not return any response, because that prevents the profiler from showing up (the same applies for the default Symfony exception screen). If you need to change the default position of this listener (see order in `bin/console debug:event-dispatcher`), use the configuration option `listener_priority`. Console integration also works out of the box, if you do not have an `console.error` listener that would prevent execution of this one. Again, this can be tweaked using the respective `listener_priority` option. Configure the `browser` option to open the exceptions directly in your browser, configured binary must be executable with [`exec()`](http://php.net/manual/en/function.exec.php). If you want to configure your application to always convert warnings and notices to exceptions use the `debug.error_handler.throw_at` parameter (see [PHP manual](http://php.net/manual/en/errorfunc.constants.php) for other available values): ``` parameters: debug.error_handler.throw_at: -1 ``` This bundle does not provide a dedicated logging functionality. If you want to use Tracy for logging e.g. in production use the [monolog-tracy-bundle](https://github.com/nella/monolog-tracy-bundle), which provides a Tracy Monolog handler. Configuration ------------- [](#configuration) Configuration structure with listed default values: ``` # config/packages/tracy_blue_screen.yaml tracy_blue_screen: controller: # Enable debug screen for controllers. # Enabled by default only in dev environment with debug mode on. enabled: ~ # Priority with which the listener will be registered. listener_priority: 0 console: # Enable debug screen for console. # Enabled by default only in dev environment with debug mode on. enabled: ~ # Directory, where BlueScreens for console will be stored. # If you are already using Tracy for logging, set this to the same. # This will be only used, if given Tracy\Logger instance does not have a directory set. log_directory: '%kernel.logs_dir%' # Configure this to open generated BlueScreen in your browser. # Configuration option may be for example 'google-chrome' # or 'firefox'and it will be invoked as a shell command. browser: null # Priority with which the listener will be registered. listener_priority: 0 blue_screen: # Add paths which should be collapsed (for external/compiled code) so that actual error is expanded. collapse_paths: # Defaults: - '%kernel.project%/bootstrap.php.cache' - '%kernel.cache_dir%' # plus paths set in BlueScreen instance used (/vendor) ``` You can also override services used internally, for example if you need to specify options for the BlueScreen instance, you can provide custom instance with an [alias](http://symfony.com/doc/current/components/dependency_injection/advanced.html#aliasing): ``` services: my_blue_screen: class: 'Tracy\BlueScreen' properties: info: - 'environment: %kernel.environment%' cdn77.tracy_blue_screen.tracy.blue_screen: '@my_blue_screen' ``` Installation ------------ [](#installation) Install package [`cdn77/tracy-blue-screen-bundle`](https://packagist.org/packages/cdn77/tracy-blue-screen-bundle) with [Composer](https://getcomposer.org/): ``` composer require cdn77/tracy-blue-screen-bundle ``` Register the bundle in your application: ``` // config/bundles.php return [ // ... Cdn77\TracyBlueScreenBundle\TracyBlueScreenBundle::class => ['all' => true], ]; ``` ### Health Score 53 — FairBetter than 97% of packages Maintenance71 Regular maintenance activity Popularity35 Limited adoption so far Community13 Small or concentrated contributor base Maturity75 Established project with proven stability Bus Factor2 2 contributors hold 50%+ of commits How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~176 days Recently: every ~310 days Total 11 Last Release 169d ago Major Versions 0.1.0 → 1.0.12023-04-03 PHP version history (6 changes)v0.0.1PHP ^7.3 || ^8.0 0.0.5PHP ^7.4 || ^8.0 0.0.6PHP ^8.0 1.0.1PHP ^8.1 1.0.2PHP ^8.2 1.0.4PHP ^8.3 ### Community Maintainers ![](https://www.gravatar.com/avatar/af6552e906a40b12da9488a4dddfa4f9f4c0fecde220e7391accdd615523c7ee?d=identicon)[simPod](/maintainers/simPod) --- Top Contributors [![VasekPurchart](https://avatars.githubusercontent.com/u/406821?v=4)](https://github.com/VasekPurchart "VasekPurchart (85 commits)")[![simPod](https://avatars.githubusercontent.com/u/327717?v=4)](https://github.com/simPod "simPod (50 commits)")[![renovate[bot]](https://avatars.githubusercontent.com/in/2740?v=4)](https://github.com/renovate[bot] "renovate[bot] (33 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (7 commits)")[![Vrtak-CZ](https://avatars.githubusercontent.com/u/112567?v=4)](https://github.com/Vrtak-CZ "Vrtak-CZ (2 commits)")[![soukicz](https://avatars.githubusercontent.com/u/1814750?v=4)](https://github.com/soukicz "soukicz (1 commits)")[![mhujer](https://avatars.githubusercontent.com/u/353372?v=4)](https://github.com/mhujer "mhujer (1 commits)") --- Tags bundledebugerrorexceptionsdebuggertracybluescreen ### Code Quality TestsPHPUnit Static AnalysisPHPStan Type Coverage Yes ### Embed Badge ![Health badge](/badges/cdn77-tracy-blue-screen-bundle/health.svg) ``` [![Health](https://phpackages.com/badges/cdn77-tracy-blue-screen-bundle/health.svg)](https://phpackages.com/packages/cdn77-tracy-blue-screen-bundle) ``` ### Alternatives [vasek-purchart/tracy-blue-screen-bundle This bundle lets you use the Tracy's debug screen in combination with the the default profiler in your Symfony application. 1177.6k](/packages/vasek-purchart-tracy-blue-screen-bundle)[recca0120/laravel-tracy A Laravel Package to integrate Nette Tracy Debugger 388283.0k3](/packages/recca0120-laravel-tracy)[symfony/ai-mate AI development assistant MCP server for Symfony projects 1624.9k11](/packages/symfony-ai-mate)[cmsig/seal-symfony-bundle An integration of CMS-IG SEAL search abstraction into Symfony Framework. 15195.8k5](/packages/cmsig-seal-symfony-bundle)[sineflow/clamav ClamAV PHP Client for Symfony 10168.5k](/packages/sineflow-clamav) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)