Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/crisu83/yii-sentry
Sentry for the Yii PHP framework.
https://github.com/crisu83/yii-sentry
Last synced: 13 days ago
JSON representation
Sentry for the Yii PHP framework.
- Host: GitHub
- URL: https://github.com/crisu83/yii-sentry
- Owner: crisu83
- License: bsd-3-clause
- Created: 2013-10-12T16:23:49.000Z (about 11 years ago)
- Default Branch: master
- Last Pushed: 2016-05-24T09:56:40.000Z (over 8 years ago)
- Last Synced: 2024-10-08T17:14:54.273Z (about 1 month ago)
- Language: PHP
- Size: 14.6 KB
- Stars: 10
- Watchers: 1
- Forks: 14
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
yii-sentry
==========
[](https://packagist.org/packages/crisu83/yii-sentry)
Sentry for the Yii PHP framework.
yii-sentry is an extension for Yii that allows for sending data to [Sentry](http://getsentry.com).
It comes with an application component that allows for centralized access to the Raven client,
an error handler that sends errors and exception to Sentry and a log route that sends log messages to Sentry.
It has never been this easy to professionally manage your errors.
## Features
* Application component for easy access to the Raven client
* Error handler that sends errors to Sentry
* Log route that sends messages to Sentry
## Resources
* [Sentry](http://getsentry.com)
* [Sentry docs](http://sentry.readthedocs.org/en/latest/)
* [Raven project](http://github.com/getsentry/raven-php)
## Setup
The easiest way to install this extension is to use [Composer](http://getcomposer.org) by adding the following to your composer.json file:
```js
"require": {
"crisu83/yii-sentry": ""
}
```
Run the following command in the root directory of your project to install the extension:
```bash
php composer.phar install
```
> TIP: Create a path alias to Composer's vendor directory called **vendor** to ease class mapping to dependencies by adding it to ```aliases``` in your application configuration.
If you do not want to use Composer, you can download the extension and its dependencies and set everything up manually.
Once you have downloaded the extension add the following to your application configuration:
```php
'components' => array(
'sentry' => array(
'class' => 'vendor.crisu83.yii-sentry.components.SentryClient',
'dns' => ''
),
),
```
The following configuration parameters are available for the SentryClient:
* **dns**: (string) dns to use when connecting to Sentry
* **environment**: (string) name of the active environment
* **enabledEnvironments**: (array) list of names for environments in which data will be sent to Sentry
* **options**: (array) options to pass to the Raven client with the following structure:
* **logger**: (string) name of the logger
* **auto_log_stacks**: (bool) whether to automatically log stacktraces
* **name**: (string) name of the server
* **site**: (string) name of the installation
* **tags**: (array) key/value pairs that describe the event
* **trace**: (bool) whether to send stacktraces
* **timeout**: (int) timeout when connecting to Sentry (in seconds)
* **exclude**: (array) class names of exceptions to exclude
* **shift_vars**: (bool) whether to shift variables when creating a backtrace
* **processors**: (array) list of data processors
## Sending errors to Sentry
To enable the SentryErrorHandler add the following to your application configuration:
```php
'components' => array(
'errorHandler' => array(
'class' => 'vendor.crisu83.yii-sentry.components.SentryErrorHandler',
),
),
```
The following configuration parameters are available for the SentryErrorHandler:
* **sentryClientID**: (string) component ID for the sentry client
That's it, now errors and exceptions will be sent to Sentry.
## Sending log messages to Sentry
To enable the SentryLogRoute add the following to your application configuration:
```php
'components' => array(
'log' => array(
'class' => 'CLogRouter',
'routes' => array(
array(
'class' => 'vendor.crisu83.yii-sentry.components.SentryLogRoute',
'levels' => 'error, warning',
),
),
),
),
```
The following configuration parameters are available for the SentryLogRoute:
* **sentryClientID**: (string) component ID for the sentry client
That's it, now log messages with levels **error** and **warning** will be sent to Sentry.
> TIP: Do not log messages with level **trace** to Sentry because it will slow down your application a lot.