Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/lordsimal/cakephp-sentry
CakePHP 4.4+ plugin integration for Sentry
https://github.com/lordsimal/cakephp-sentry
Last synced: 3 months ago
JSON representation
CakePHP 4.4+ plugin integration for Sentry
- Host: GitHub
- URL: https://github.com/lordsimal/cakephp-sentry
- Owner: LordSimal
- License: mit
- Created: 2022-10-21T14:28:52.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2023-12-02T06:49:50.000Z (7 months ago)
- Last Synced: 2024-01-08T10:41:01.338Z (6 months ago)
- Language: PHP
- Size: 313 KB
- Stars: 7
- Watchers: 1
- Forks: 2
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Lists
- awesome-cakephp - Sentry plugin
README
# CakePHP Sentry Plugin
[](https://packagist.org/packages/lordsimal/cakephp-sentry) [](https://packagist.org/packages/lordsimal/cakephp-sentry) [](https://packagist.org/packages/lordsimal/cakephp-sentry) [](https://packagist.org/packages/lordsimal/cakephp-sentry) [](https://packagist.org/packages/lordsimal/cakephp-sentry)
[](https://codecov.io/gh/LordSimal/cakephp-sentry)
CakePHP integration for Sentry.
âšī¸ This is a refactored version of https://github.com/Connehito/cake-sentry to remove deprecation warnings introduced in CakePHP 4.4
âšī¸ If you are using CakePHP 3.x or 4.0 - 4.3 please use the plugin from Connehito linked above
## Requirements
- PHP 7.4+ / PHP 8.0+
- CakePHP 4.4+
- and a [Sentry](https://sentry.io) account
## Version table
| | PHP | CakePHP | self-hosted Sentry |
|-----|------------------|---------|--------------------|
| 1.x | `^7.4 \|\| ^8.0` | `^4.4` | đ¤ˇđģ |
| 2.x | `^8.1` | `^5.0` | đ¤ˇđģ |
| 3.x | `^8.1` | `^5.0` | `>= v20.6.0` |
## Installation
```
composer require lordsimal/cakephp-sentry
```
## Usage
### Set config files
```php
// in `config/app.php`
return [
'Sentry' => [
'dsn' => '',
'environment' => 'production',
]
];
```
### Loading plugin
In Application.php
```php
public function bootstrap()
{
parent::bootstrap();
$this->addPlugin(\CakeSentry\CakeSentryPlugin::class);
}
```
Or use the cake CLI.
```
bin/cake plugin load CakeSentry
```
That's all! đ
â ī¸ī¸ If events (error/exception) are not captured in Sentry try changing the order in which the plugins are loaded.
### Advanced Usage
#### Ignore specific exceptions
You can filter out noisy exceptions which should not be debugged further.
```php
// in `config/app.php`
'Error' => [
'skipLog' => [
NotFoundException::class,
MissingRouteException::class,
MissingControllerException::class,
],
]
```
Also see [CakePHP Cookbook](https://book.cakephp.org/4/en/development/errors.html#error-exception-configuration)
### Set Options
Everything inside the `'Sentry'` configuration key will be passed to `\Sentry\init()`.
Please check Sentry's official documentation on [about configuration](https://docs.sentry.io/error-reporting/configuration/?platform=php) and [about php-sdk's configuraion](https://docs.sentry.io/platforms/php/#php-specific-options).
CakeSentry also provides custom event hooks to set dynamic values.
| Event Name | Description |
|-----------------------------------|------------------------------------------------------|
| `CakeSentry.Client.afterSetup` | General config for e.g. a release info |
| `CakeSentry.Client.beforeCapture` | Before an error or exception is being sent to sentry |
| `CakeSentry.Client.afterCapture` | After an error or exception has been sent to sentry |
### Example for `CakeSentry.Client.afterSetup`
```php
use Cake\Event\Event;
use Cake\Event\EventListenerInterface;
class SentryOptionsContext implements EventListenerInterface
{
public function implementedEvents(): array
{
return [
'CakeSentry.Client.afterSetup' => 'setServerContext',
];
}
public function setServerContext(Event $event): void
{
/** @var \CakeSentry\Http\SentryClient $subject */
$subject = $event->getSubject();
$options = $subject->getHub()->getClient()->getOptions();
$options->setEnvironment('test_app');
$options->setRelease('3.0.0@dev');
}
}
```
And in `config/bootstrap.php`
```php
\Cake\Event\EventManager::instance()->on(new SentryOptionsContext());
```
### Example for `CakeSentry.Client.beforeCapture`
```php
use Cake\Event\Event;
use Cake\Event\EventListenerInterface;
use Sentry\State\Scope;
use function Sentry\configureScope as sentryConfigureScope;
class SentryErrorContext implements EventListenerInterface
{
public function implementedEvents(): array
{
return [
'CakeSentry.Client.beforeCapture' => 'setContext',
];
}
public function setContext(Event $event): void
{
if (PHP_SAPI !== 'cli') {
sentryConfigureScope(function (Scope $scope) use ($event) {
$request = \Cake\Routing\Router::getRequest();
$scope->setTag('app_version', $request->getHeaderLine('App-Version') ?: 1.0);
$exception = $event->getData('exception');
if ($exception) {
assert($exception instanceof \Exception);
$scope->setTag('status', $exception->getCode());
}
$scope->setUser(['ip_address' => $request->clientIp()]);
$scope->setExtras([
'foo' => 'bar',
'request attributes' => $request->getAttributes(),
]);
});
}
}
}
```
And in `config/bootstrap.php`
```php
\Cake\Event\EventManager::instance()->on(new SentryErrorContext());
```
### Example for `CakeSentry.Client.afterCapture`
```php
use Cake\Event\Event;
class SentryErrorContext implements EventListenerInterface
{
public function implementedEvents(): array
{
return [
'CakeSentry.Client.afterCapture' => 'callbackAfterCapture',
];
}
public function callbackAfterCapture(Event $event): void
{
$lastEventId = $event->getData('lastEventId');
}
}
```
### Query logging (optional)
If you want sentry events to also have query logging enabled you can do this via your config:
```php
'CakeSentry' => [
'enableQueryLogging' => true
]
```
If you want queries related to schema reflection also inside your events then you can enable that via
```php
'CakeSentry' => [
'includeSchemaReflection' => true
]
```
## License
The plugin is available as open source under the terms of the [MIT License](https://github.com/lordsimal/cakephp-sentry/blob/master/LICENSE).