Download the PHP package connehito/cake-sentry without Composer
On this page you can find all versions of the php package connehito/cake-sentry. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Informations about the package cake-sentry
CakePHP Sentry Plugin
CakePHP integration for Sentry.
Requirements
- PHP 7.2+ / PHP 8.0+
- CakePHP 4.0+
- and Sentry account
💡 For CakePHP3.x, use 2.x branch.
Installation
With composer install.
If you do not have the php-http/async-client-implementation
package, you will need to install it together.
In that case, you will get a message like the following
Then, you can use the following command to provide a package such as symfony/http-client
.
You can find the available packages on Packagist.
Usage
Set config files.
Write your sentry account info.
Loading plugin.
In Application.php
Or use cake command.
That's all! :tada:
NOTE:
If the events(error/exception) don't be captured in Sentry, try changing the order in which the plugins are loaded.
It is recommended to load this plugin after running BaseApplication::bootstrap()
and loading other plugins.
Advanced Usage
Ignore noisy exceptions
You can filter out exceptions that make a fuss and harder to determine the issues to address(like PageNotFoundException)
Set exceptions not to log in Error.skipLog
.
ex)
ref: CakePHP Cookbook
https://book.cakephp.org/4/en/development/errors.html#error-exception-configuration
Set Options
All configure written in Configure::write('Sentry')
will be passed to Sentry\init()
.
Please check Sentry's official document about configuration and about php-sdk's configuraion.
In addition to it, CakeSentry provides event hook to set dynamic values to options more easily if you need.
Client dispatch CakeSentry.Client.afterSetup
event before sending error to sentry.
Subscribe the event with your logic.
ex)
And in config/bootstrap.php
Send more context
Client dispatch CakeSentry.Client.beforeCapture
event before sending error to sentry.
You can set context with EventListener.With facade sentryConfigureScope()
etc, or with $event->getContext()->getHub()
to access and set context.
In case you want to handle the information in server request, cake-sentry supports to get Request
instance in implemented event via $event->getData('request')
.
See also the section about context in offical doc.
ex)
And in config/bootstrap.php
Collecting User feedback
In CakeSentry.Client.afterCapture
event, you can get last event ID.
See also offcial doc.
ex)
Contributing
Pull requests and feedback are very welcome :)
on GitHub at https://github.com/connehito/cake-sentry .
License
The plugin is available as open source under the terms of the MIT License.