4.0

Migrations to 4.0.0

Change summary

4.0.0 is the first release for compatibility for PHP 8.
For this reason, the version that the Sentry SDK CakeSentry depends on internally has been changed to 3.x.

The main changes are summarized in the following points:

• The cake sentry itself no longer directly requires a concrete HTTP Client, and users can now choose the php-http/async-client-implementation package of their choice.
  • It means that you can use php-http/guzzle6-adapter or php-http/guzzle7-adapter, etc. if your project already uses any of them.
• On recording events other than Exception, traces used to be recorded as Breadcrumbs, but now they will be recorded as stackTrace.
• prefixes and in_app_exclude are now set automatically.
  • For more information about these, please refer to the official Sentry documentation (https://docs.sentry.io/platforms/php/configuration/options/#in-app-exclude)

If you are already using an async-http-implementation client (such as php-http/guzzle*-adapter) and have not changed the configuration of Sentry itself, it is assumed that you can seamlessly migrate from 3.x to this version.
Due to some changes in the handling of stackTrace, existing issues in applications may be logged as separate issues after upgrading CakeSentry.

Requirements

• PHP 7.2+ / PHP8.0+ is required

Changes

As in 3.0, there are no particular changes to the public API provided by the CakeSentry plugin itself.
However, please note that the Sentry's Option set by the user may need to be changed due to major version upgrades of the sentry SDK on which it depends.
see: sentry-php/UPGRADE-3.0.md at master · getsentry/sentry-php