error-tracker / yii2-log-target
Installs: 12 570
Dependents: 0
Suggesters: 0
Security: 0
Stars: 0
Watchers: 3
Forks: 0
Open Issues: 1
Requires
- error-tracker/php-sdk: ^0.1.0
- yiisoft/yii2: ^2.0
Requires (Dev)
- phpunit/phpunit: ^7
- squizlabs/php_codesniffer: ^2.8
This package is auto-updated.
Last update: 2024-10-16 04:15:17 UTC
README
Who is this for?
This is for Yii2 developers that need to integrate their applications with Error Tracker. This extension uses the Yii2 log component to send errors and warnings direct to Error Tracker.
Installation
Install this package with composer.
composer require error-tracker/yii2-log-target
Configuration
To configure the log target in your application, add the below config. Whenever there is a server side error this will be added to the file log as it normally would. Additionally this will be sent to the error tracker dashboard, for easy searches, alerts and other handy tools.
'log' => [ 'targets' => [ [ 'class' => 'yii\log\FileTarget', 'levels' => ['error', 'warning'], ], [ 'class' => 'ErrorTracker\Yii2\ErrorTrackerTarget', 'levels' => ['error', 'warning'], 'app_key' => 'YOUR_APP_KEY' ], ], ],
When an error is reported onto Error Tracker, it will be saved with a
Reference
. This is your user's session id, and is also the id you can use to
trace the error in your file log where you can find more information about that error
error.
Using Yii2's log functions
You can use Yii2's error and warning methods to log errors to Error Tracker without throwing exceptions. This will still be logged in the same way, and will additionally and automatically sent if you have the log target configured. The below code will send an error without throwing an exception.
try { $this->willBreake(); } catch (\Exception $e) { Yii::error($e->getMessage(), $e->getName()); }
Disabling
Disable your log target by using the method documented by
Yii2.
Optionally disable the target by setting the enabled
property in the
configuration. The below config only enables the logger if your application
is in a production environment.
[ 'class' => 'ErrorTracker\Yii2\ErrorTrackerTarget', 'levels' => ['error', 'warning'], 'app_key' => 'YOUR_APP_KEY', 'enabled' => YII_ENV_PROD, ],
Contributing
Getting set up
Clone the repo and run composer install
.
Then start hacking!
Testing
All new features of bug fixes must be tested. Testing is with phpunit and can be run with the following command.
composer run-script test
Coding Standards
This library uses psr2 coding standards and squizlabs/php_codesniffer
for
linting. There is a composer script for this:
composer run-script lint
Pull Requests
Before creating a pull request with your changes, the pre-commit script must pass. That can be run as follows:
composer run-script pre-commit
Credits
This package is created and maintained by Practically.io