This package provides extra strategies to be used with the Rollbar SDK for PHP. The base Rollbar SDK comes with some default strategies for truncation, but they don't always do everything that is needed. The configuration allows for specifying custom strategies for transforming, truncating, etc, and this package aims to provide some of these custom strategies.
Via Composer
$ composer require shiftonelabs/php-rollbar-extensionsRollbar configuration is dependent on the framework/application being used.
Rollbar documentation for installing rollbar for PHP: https://docs.rollbar.com/docs/php
Rollbar configuration options: https://docs.rollbar.com/docs/php-configuration-reference
This package provides a set of classes that can be provided to the Rollbar configuration. For the most part, usage of this queue driver is the same as the built in queue drivers. There are, however, a few extra things to consider when working with Amazon's SQS FIFO queues.
Allows creating dynamic custom data on runtime during error reporting. The callable taking two parameters
$toLog(the context of what's being logged) and$context(additional context data provided in the config). You provide$contextby addingcustom_data_method_contextkey to the$extraor$contextparametersRollbar::logorRollbarLogger::log.
To specify a custom data method to use, set the custom_data_method key of the Rollbar config to a new instance of an invocable Custom Data Method class. These classes should implement the \ShiftOneLabs\PhpRollbarExtensions\CustomDataInterface interface.
No custom data methods available yet.
A fully qualified name of your custom truncation strategy class. It has to inherit from
\Rollbar\Truncation\AbstractStrategy. This custom strategy will be applied before the built-in strategies.
To specify a custom truncation to use, set the custom_truncation key of the Rollbar config to the fully qualified name of the class to use.
No custom truncation methods available yet.
From Rollbar:
The class to be used to transform the payload before it gets prepared for sending to Rollbar API. It has to implement
\Rollbar\TransformerInterface.
To specify a transformer to use, set the transformer key of the Rollbar config to the fully qualified name of the class to use.
Available transformers:
| Transformer | Description |
|---|---|
AddExceptionPropertiesTransformer |
Adds all properties of the exception to the Rollbar log. |
When an exception is logged to Rollbar, only the basic exception information is sent to Rollbar (exception name, message, code, line number, file, previous exception, and stack trace). However, if you have created a custom exception with additional properties, the values of those properties are not sent to Rollbar by default. Sometimes this information is very valuable in attempting to debug the issue.
The AddExceptionPropertiesTransformer transformer will add all data stored on the exception to the "custom" element of the Rollbar payload, under a new "properties" key. This includes all defined public, protected, and private properties, as well as any properties dynamically assigned at runtime. This transformer also traverses the exception chain, so all the properties for the set "previous" exceptions will be reported, as well. This custom data will be displayed in Rollbar for each occurrence.
Example configuration: 'transformer' => \ShiftOneLabs\PhpRollbarExtensions\Transformers\AddExceptionPropertiesTransformer::class
Contributions are welcome. Please see CONTRIBUTING for details.
If you discover any security related issues, please email patrick@shiftonelabs.com instead of using the issue tracker.
The MIT License (MIT). Please see License File for more information.