Download the PHP package evolution7/bugsnag-bundle without Composer
On this page you can find all versions of the php package evolution7/bugsnag-bundle. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download evolution7/bugsnag-bundle
More information about evolution7/bugsnag-bundle
Files in evolution7/bugsnag-bundle
Package bugsnag-bundle
Short Description Bugsnag error reporting integration for Symfony2
License MIT
Homepage https://github.com/evolution7/Evolution7BugsnagBundle
Informations about the package bugsnag-bundle
Evolution7BugsnagBundle
Enables Bugsnag integration into your Symfony application, using the bugsnag-php 2.x library from Bugsnag.
Installation
The recommended way of installing this bundle is using Composer.
Add this repository to your composer information using the following command
Add the bundle to your AppKernel.php:
Define your Bugsnag API key in the config.yml
Usage
After the installation the bundle works without any additional settings required, but you can tweak some settings.
Enabled Stages
You can set for which Symfony environments (kernel.environment
) you want Bugsnag to be enabled. This is done through the enabled_stages setting:
These environments should match the environment as set in your application's web/app.php
, web/app_dev.php
and/or app/console
. The default is to report bugs for the prod
environment only.
Notify Stages
You can set for which environments you want Bugsnag to get error reports. This is done with the notify_stages setting:
The default is to report bugs in staging and production environments.
Proxy
If your server requires you to access Bugsnag through a proxy, you can set this up easily as well. Just use the following example to configure the settings you need in your config.yml:
The only of these settings that is mandatory is the host, all others can be left out if they aren't required.
AppVersion
If you tag your app releases with version numbers, Bugsnag can display these on your dashboard if you set this:
Testing
Included in the bundle is a controller that will allow you to test if your site is hooked up correctly. Just add the following to your routing.yml:
And then afterwards you can access your.domain/bugsnagtest/exception
and your.domain/bugsnagtest/error
which should then send errors to your configured Bugsnag project.
Advanced Usage
Release Stage Class
Bugsnag allows you to determine which release stage you are currently in, the Evolution7BugsnagBundle uses a ReleaseStage class for this which determines this based on the path. Depending on your setup you might want to have a different way of determining this, in which case it is possible to override this by providing your own ReleaseStage class.
You can implement a class that implements the Evolution7\BugsnagBundle\ReleaseStage\ReleaseStageInterface
and provide its name as a parameter in your config.yml
User Information
Bugsnag gives the possibility to give userdata as additional information to a request. If you give an id, name or email these fields will be searchable. Other fields are allowed but not searchable - they will only be displayed. The bundle allows to set a user to array converter as a service which will be used to send user data. The given service must be an instance of \Evolution7\BugsnagBundle\UserInterface
Contributing
- Fork it on Github
- Commit and push until you are happy
- Run the tests to make sure they all pass: composer install && ./vendor/bin/phpunit
- Make a pull request
- Thanks!
Acknowledgement
Parts of this code are based on the bugsnag-php-symfony Bundle