PHPackages                             vasek-purchart/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. vasek-purchart/tracy-blue-screen-bundle

ActiveLibrary[Debugging & Profiling](/categories/debugging)

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.

4.0(1y ago)1177.6k↓30.8%8[2 PRs](https://github.com/VasekPurchart/Tracy-Blue-Screen-Bundle/pulls)MITPHPPHP ^7.2CI passing

Since May 19Pushed 1y ago1 watchersCompare

[ Source](https://github.com/VasekPurchart/Tracy-Blue-Screen-Bundle)[ Packagist](https://packagist.org/packages/vasek-purchart/tracy-blue-screen-bundle)[ RSS](/packages/vasek-purchart-tracy-blue-screen-bundle/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (10)Dependencies (17)Versions (15)Used By (0)

Tracy BlueScreen Bundle
=======================

[](#tracy-bluescreen-bundle)

**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).

This bundle expects that you are using the default Symfony `ErrorController`. You could use it with different one, you just need to pass `vasek_purchart.tracy_blue_screen.blue_screen.error_renderer` to it.

Console integration also works out of the box, if you do not have an `console.error` listener that would prevent execution of this one. 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`.

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: ~

    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_dir%/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%'

    vasek_purchart.tracy_blue_screen.tracy.blue_screen: '@my_blue_screen'
```

Installation
------------

[](#installation)

Install package [`vasek-purchart/tracy-blue-screen-bundle`](https://packagist.org/packages/vasek-purchart/tracy-blue-screen-bundle) with [Composer](https://getcomposer.org/):

```
composer require vasek-purchart/tracy-blue-screen-bundle
```

Register the bundle in your application:

```
// config/bundles.php
return [
	// ...
	VasekPurchart\TracyBlueScreenBundle\TracyBlueScreenBundle::class => ['all' => true],
];
```

###  Health Score

44

—

FairBetter than 92% of packages

Maintenance40

Moderate activity, may be stable

Popularity38

Limited adoption so far

Community16

Small or concentrated contributor base

Maturity66

Established project with proven stability

 Bus Factor1

Top contributor holds 93.8% of commits — single point of failure

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 ~290 days

Recently: every ~732 days

Total

13

Last Release

539d ago

Major Versions

0.6 → 1.02016-08-05

1.0.1 → 2.02017-05-10

2.0 → 3.02018-06-21

3.0.1 → 4.02024-11-26

PHP version history (7 changes)0.1PHP ~5.5

0.4PHP ~5.5|~7.0

0.5PHP ~5.6|~7.0

2.0PHP ~7.0

3.0PHP ~7.1

3.0.1PHP ~7.2

4.0PHP ^7.2

### Community

Maintainers

![](https://www.gravatar.com/avatar/48831f7e09a459d6f2761d53922e26cef1579c030524f5c36f54964f0d6541e1?d=identicon)[VasekPurchart](/maintainers/VasekPurchart)

---

Top Contributors

[![VasekPurchart](https://avatars.githubusercontent.com/u/406821?v=4)](https://github.com/VasekPurchart "VasekPurchart (136 commits)")[![petrduda](https://avatars.githubusercontent.com/u/31613421?v=4)](https://github.com/petrduda "petrduda (5 commits)")[![Vrtak-CZ](https://avatars.githubusercontent.com/u/112567?v=4)](https://github.com/Vrtak-CZ "Vrtak-CZ (2 commits)")[![mhujer](https://avatars.githubusercontent.com/u/353372?v=4)](https://github.com/mhujer "mhujer (1 commits)")[![soukicz](https://avatars.githubusercontent.com/u/1814750?v=4)](https://github.com/soukicz "soukicz (1 commits)")

---

Tags

bundledebugerrorexceptionsdebuggertracybluescreen

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/vasek-purchart-tracy-blue-screen-bundle/health.svg)

```
[![Health](https://phpackages.com/badges/vasek-purchart-tracy-blue-screen-bundle/health.svg)](https://phpackages.com/packages/vasek-purchart-tracy-blue-screen-bundle)
```

###  Alternatives

[shopware/platform

The Shopware e-commerce core

3.3k1.5M3](/packages/shopware-platform)[sulu/sulu

Core framework that implements the functionality of the Sulu content management system

1.3k1.3M152](/packages/sulu-sulu)[prestashop/prestashop

PrestaShop is an Open Source e-commerce platform, committed to providing the best shopping cart experience for both merchants and customers.

9.0k15.4k](/packages/prestashop-prestashop)[simplesamlphp/simplesamlphp

A PHP implementation of a SAML 2.0 service provider and identity provider.

1.1k12.4M193](/packages/simplesamlphp-simplesamlphp)[shopware/core

Shopware platform is the core for all Shopware ecommerce products.

595.2M386](/packages/shopware-core)[drupal/core-recommended

Locked core dependencies; require this project INSTEAD OF drupal/core.

6939.5M343](/packages/drupal-core-recommended)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)