kutny/tracy-bundle

Nette Tracy debugger for Symfony

Tracy PHP debugger bundle for Symfony

This bundle adds the powerful Tracy debug tool to the Symfony2 framework., _(*1)

, _(*2)

Why is Tracy better than the Symfony build-in debugger?, _(*3)

• Exception stack trace contains values of all method arguments.
• Request & Response & Server environment information is displayed on the error page.
• The whole error page with full stack trace can be easily stored to some directory as HTML file (useful on production mode).
• Webmaster can be notified by email about errors that occured on the site.

See full Tracy docs and sample error page., _(*4)

Tracy is a part of the Nette Framework., _(*5)

Installation

1) Install via composer:, _(*6)

~~~~~ bash composer require kutny/tracy-bundle, _(*7)

2) Add KutnyTracyBundle to your application kernel.
For This bundle to catch as many errors as possible it should be the first bundle in the bundles array.

~~~~~ php
// app/AppKernel.php
public function registerBundles()
{
    return array(
        new Kutny\TracyBundle\KutnyTracyBundle(),
        // ...
    );
}

Configuration

1) app.php / app_dev.php, _(*8)

Open web/app.php and web/app_dev.php files and add the following code before the AppKernel class is instantiated:, _(*9)

~~~~~ php \Tracy\Debugger::enable();, _(*10)

Or force the **production mode** where only [general server error page](http://nette.github.io/tracy/images/tracy-error2.png) will be displayed to the user ([read more](https://github.com/nette/tracy#production-mode-and-error-logging)):

~~~~~ php
\Tracy\Debugger::enable(\Tracy\Debugger::PRODUCTION);

I also recommend you to enable Tracy in a strict mode so it can handle errors of type E_NOTICE and E_WARNING too., _(*11)

~~~~~ php \Tracy\Debugger::$strictMode = true;, _(*12)

**2) config.yml**

~~~~~ yaml
kutny_tracy:
    emails: ['errors@mycompany.com'] # error notification recipients
    exceptions_directory: <directory> # optional, default directory set to %kernel.logs_dir%/exceptions
    store_username_in_server_variable: true|false # optional, default value = false; stores username of logged user in $_SERVER['SYMFONY_USERNAME'] - helps you to find out which user encountered the error
    ignored_exceptions:
        - Symfony\Component\HttpKernel\Exception\BadRequestHttpException
        - RuntimeException
        - UnexpectedValueException

License

This bundle license: https://github.com/kutny/tracy-bundle/blob/master/LICENSE, _(*13)

Tracy debugger license: https://github.com/nette/tracy/blob/master/license.md, _(*14)