| Server IP : 78.140.185.180 / Your IP : 3.15.190.49 Web Server : LiteSpeed System : Linux cpanel13.v.fozzy.com 4.18.0-513.11.1.lve.el8.x86_64 #1 SMP Thu Jan 18 16:21:02 UTC 2024 x86_64 User : builderbox ( 1072) PHP Version : 7.3.33 Disable Function : NONE MySQL : OFF | cURL : ON | WGET : ON | Perl : ON | Python : ON | Sudo : OFF | Pkexec : OFF Directory : /home/builderbox/public_html/vendor/sentry/sentry/ |
Upload File : |
# Upgrade from 1.10 to 2.0
Version `2.x` is a complete rewrite of the existing code base. The public API has been trimmed down to a minimum.
The preferred way of using the SDK is through our "Static API" / global functions.
Here is a simple example to get started:
```php
\Sentry\init(['dsn' => '___PUBLIC_DSN___' ]);
\Sentry\configureScope(function (\Sentry\State\Scope $scope): void {
$scope->setTag('page_locale', 'de-at');
$scope->setUser(['email' => 'john.doe@example.com']);
$scope->setLevel(\Sentry\Severity::warning());
$scope->setExtra('character_name', 'Mighty Fighter');
});
// The following capture call will contain the data from the previous configured Scope
try {
thisFunctionThrows(); // -> throw new \Exception('foo bar');
} catch (\Exception $exception) {
\Sentry\captureException($exception);
}
\Sentry\addBreadcrumb(new Breadcrumb(Breadcrumb::LEVEL_ERROR, Breadcrumb::TYPE_ERROR, 'error_reporting', 'Message'));
```
The call to `\Sentry\init()` sets up global exception/error handlers and any uncaught error will be sent to Sentry.
Version `>= 2.0` conforms to the [Unified SDK API](https://docs.sentry.io/development/sdk-dev/unified-api/).
It has a fundamentally different concept, it's no longer recommended to just use a `Client` unless you really know what you are doing.
Please visit [our docs](https://docs.sentry.io/error-reporting/quickstart/?platform=php) to get a full overview.
### Client options
- The `exclude` option has been removed.
- The `excluded_app_path` option has been renamed to `in_app_exclude`
- The `send_callback` option has been renamed to `before_send`.
- The `name` option has been renamed to `server_name`.
- The `secret_key` option has been removed.
- The `public_key` option has been removed.
- The `message_limit` option has been removed.
- The `project` option has been removed.
- The `severity_map` option has been removed.
- The `ignore_server_port` option has been removed.
- The `trust_x_forwarded_proto` option has been removed.
- The `mb_detect_order` option has been removed.
- The `trace` option has been removed.
- The `tags` option has been removed in favour of setting them in the scope.
- The `site` option has been removed.
- The `extra_data` option has been removed in favour of setting additional data
in the scope.
- The `curl_method` option has been removed.
- The `curl_path` option has been removed.
- The `curl_ipv4` option has been removed.
- The `curl_ssl_version` option has been removed.
- The `verify_ssl` option has been removed.
- The `ca_cert` option has been removed.
- The `proxy` option has been removed in favour of leaving to the user the burden
of configuring the HTTP client options using a custom client.
- The `processors` option has been removed.
- The `processors_options` option has been removed.
- The `transport` option has been removed in favour of setting it using the
client builder.
- The `install_default_breadcrumb_handlers` option has been removed.
- The `serialize_all_object` option has been removed.
- The `context_lines` option has been added to configure the number of lines of
code context to capture.
- The `max_value_length` option has been added to set an upper bound to the length
of serialized items.
- The `server` option has been renamed to `dsn`.
### Misc
- All the classes have been renamed and moved around to follow the PSR-4
convention and `final` have been added where appropriate.
- The `Raven_Autoloader` class has been removed. To install and use the
library you are required to use [Composer](https://getcomposer.org/).
- The `Raven_Util` class has been removed.
- The `Raven_Compat` class has been removed.
- The `Raven_Util` class has been removed.
- The `Raven_CurlHandler` class has been removed.
- The `Raven_TransactionStack` class has been removed.
- The `Raven_Exception` class has been removed.
### Client
- The constructor of the `Client` (before `Raven_Client`) class has changed its signature and
now requires to be passed a configuration object, an instance of a transport
and an event factory.
Before:
```php
public function __construct($options_or_dsn = null, $options = array())
{
// ...
}
```
After:
```php
public function __construct(Options $options, TransportInterface $transport, EventFactoryInterface $eventFactory)
{
// ...
}
```
The suggested way to create your own instance of the client is to use the provided builder (`ClientBuilder`) that will take care of instantiating a few dependencies like the PSR-7 factories and the HTTP client.
- The method `Raven_Client::close_all_children_link` has been removed and there
- The methods `Raven_Client::getRelease` and `Raven_Client::setRelease` have
been removed. You should use `Options::getRelease` and `Options::setRelease`
instead.
Before:
```php
$client->getRelease();
$client->setRelease(...);
```
After:
```php
use Sentry\State\Hub;
$options = Hub::getCurrent()->getClient()->getOptions();
$options->getRelease();
$options->setRelease(...);
```
- The methods `Raven_Client::getEnvironment` and `Raven_Client::setEnvironment`
have been removed. You should use `Options::getEnvironment` and `Options::setEnvironment`
instead.
Before:
```php
$client->getEnvironment();
$client->setEnvironment(...);
```
After:
```php
use Sentry\State\Hub;
$options = Hub::getCurrent()->getClient()->getOptions();
$options->getEnvironment();
$options->setEnvironment(...);
```
- The method `Raven_Client::getInputStream` has been removed.
- The methods `Raven_Client::getDefaultPrefixes` and `Raven_Client::setPrefixes`
have been removed. You should use `Options::getPrefixes` and
`Options::setPrefixes` instead.
Before:
```php
$client->getPrefixes();
$client->setPrefixes(...);
```
After:
```php
use Sentry\State\Hub;
$options = Hub::getCurrent()->getClient()->getOptions();
$options->getPrefixes();
$options->setPrefixes(...);
```
- The methods `Raven_Client::getAppPath` and `Raven_Client::setAppPath` have been
removed. You should use `Options::getProjectRoot` and `Options::setProjectRoot`
instead.
Before:
```php
$client->getAppPath();
$client->setAppPath(...);
```
After:
```php
use Sentry\State\Hub;
$options = Hub::getCurrent()->getClient()->getOptions();
$options->getProjectRoot();
$options->setProjectRoot(...);
```
- The methods `Raven_Client::getExcludedAppPaths` and `Raven_Client::setExcludedAppPaths`
have been removed. You should use `Options::getInAppExcludedPaths`
and `Options::setInAppExcludedPaths` instead.
Before:
```php
$client->getExcludedAppPaths();
$client->setExcludedAppPaths(...);
```
After:
```php
use Sentry\State\Hub;
$options = Hub::getCurrent()->getClient()->getOptions();
$options->getExcludedAppPaths();
$options->setExcludedAppPaths(...);
```
- The methods `Raven_Client::getSendCallback` and `Raven_Client::setSendCallback`
have been removed. You should use `Options::getBeforeSendCallback` and
`Options::setBeforeSendCallback` instead.
Before:
```php
$client->getSendCallback();
$client->setSendCallback(...);
```
After:
```php
use Sentry\State\Hub;
$options = Hub::getCurrent()->getClient()->getOptions();
$options->getBeforeSendCallback();
$options->setBeforeSendCallback(...);
- The method `Raven_Client::getServerEndpoint` has been removed. You should use
`Options::getDsn` instead.
Before:
```php
$client->getServerEndpoint();
```
After:
```php
use Sentry\State\Hub;
$options = Hub::getCurrent()->getClient()->getOptions();
$options->getDsn();
```
- The methods `Raven_Client::getTransport` and `Raven_Client::setTransport` have
been removed. The transport is now a required dependency of the client and must
be passed as required constructor argument.
- The method `Raven_Client::getUserAgent` has been removed.
- The method `Raven_Client::getErrorTypes` has been removed. You should use
`Configuration::getErrorTypes` instead.
Before:
```php
$client->getErrorTypes();
```
After:
```php
$client->getConfig()->getErrorTypes();
```
- The `Raven_Client::getDefaultProcessors` method has been removed.
- The `Raven_Client::setProcessorsFromOptions` method has been removed.
- The `Raven_Client::getLastEventID` method has been removed. The ID of the
last event that was captured is now returned by each of the `Client::capture*`
methods. You can also use `Hub::getCurrent()->getLastEventId()`.
- The `Raven_Client::parseDSN` method has been removed.
- The `Raven_Client::getLastError` method has been removed.
- The `Raven_Client::getIdent` method has been removed.
- The `Raven_Client::registerShutdownFunction` method has been removed.
- The `Raven_Client::is_http_request` method has been removed.
- The `Raven_Client::get_http_data` method has been removed.
- The `Raven_Client::get_user_data` method has been removed.
- The `Raven_Client::get_extra_data` method has been removed.
- The `Raven_Client::get_default_data` method has been removed.
- The `Raven_Client::message` method has been removed.
- The `Raven_Client::exception` method has been removed.
- The `Raven_Client::captureQuery` method has been removed.
- The `Raven_Client::captureMessage` method has changed its signature.
Before:
```php
public function captureMessage($message, $params = array(), $data = array(), $stack = false, $vars = null)
{
// ...
}
```
After:
```php
public function captureMessage(string $message, ?Severity $level = null, ?Scope $scope = null): ?string
{
// ...
}
```
- The `Raven_Client::captureException` method has changed its signature.
Before:
```php
public function captureException($exception, $data = null, $logger = null, $vars = null)
{
// ...
}
```
After:
```php
public function captureException(\Throwable $exception, ?Scope $scope = null): ?string
{
// ...
}
```
- The `Raven_Client::captureLastError` method has changed its signature.
Before:
```php
public function captureLastError()
{
// ...
}
```
After:
```php
public function captureLastError(?Scope $scope = null): ?string
{
// ...
}
```
- The method `Raven_Client::capture` has been removed.
- The method `Raven_Client::sanitize` has been removed.
- The method `Raven_Client::process` has been removed.
- The method `Raven_Client::sendUnsentErrors` has been removed.
- The method `Raven_Client::encode` has been removed.
- The method `Raven_Client::send` has been removed.
- The method `Raven_Client::send_remote` has been removed.
- The method `Raven_Client::get_default_ca_cert` has been removed.
- The method `Raven_Client::get_curl_options` has been removed.
- The method `Raven_Client::send_http` has been removed.
- The method `Raven_Client::buildCurlCommand` has been removed.
- The method `Raven_Client::send_http_asynchronous_curl_exec` has been removed.
- The method `Raven_Client::send_http_synchronous` has been removed.
- The method `Raven_Client::get_auth_header` has been removed.
- The method `Raven_Client::getAuthHeader` has been removed.
- The method `Raven_Client::uuid4` has been removed.
- The method `Raven_Client::get_current_url` has been removed.
- The method `Raven_Client::isHttps` has been removed.
- The method `Raven_Client::translateSeverity` has been removed.
- The method `Raven_Client::registerSeverityMap` has been removed.
- The method `Raven_Client::set_user_data` has been removed.
- The method `Raven_Client::onShutdown` has been removed.
- The method `Raven_Client::createProcessors` has been removed.
- The method `Raven_Client::setProcessors` has been removed.
- The method `Raven_Client::getLastSentryError` has been removed.
- The method `Raven_Client::getShutdownFunctionHasBeenSet` has been removed.
- The method `Raven_Client::close_curl_resource` has been removed.
- The method `Raven_Client::setSerializer` has been removed. You can set it
using the client builder.
Before:
```php
$client = new Raven_Client();
$client->setSerializer(...);
```
After:
```php
use Sentry\ClientBuilder;
$clientBuilder = ClientBuilder::create();
$clientBuilder->setSerializer(...);
```
- The method `Raven_Client::setReprSerializer` has been removed. You can set it
using the client builder.
Before:
```php
$client = new Raven_Client();
$client->setSerializer(...);
```
After:
```php
use Sentry\ClientBuilder;
$clientBuilder = ClientBuilder::create();
$clientBuilder->setRepresentationSerializer(...);
```
- The method `Raven_Client::cleanup_php_version` has been removed.
- The method `Raven_Client::registerDefaultBreadcrumbHandlers` has been removed.
- The `Raven_Client::user_context` method has been removed. You can set this
data in the current active scope.
Before:
```php
$client->user_context(array('foo', 'bar'));
```
After:
```php
use Sentry\State\Hub;
use Sentry\State\Scope;
Hub::getCurrent()->configureScope(function (Scope $scope): void {
$scope->setUser(['email' => 'foo@example.com']);
});
```
- The `Raven_Client::tags_context` method has been removed. You can set this
data in the current active scope.
Before:
```php
$client->tags_context(array('foo', 'bar'));
```
After:
```php
use Sentry\State\Hub;
use Sentry\State\Scope;
Hub::getCurrent()->configureScope(function (Scope $scope): void {
$scope->setTag('tag_name', 'tag_value');
});
```
- The `Raven_Client::extra_context` method has been removed. You can set this
data in the current active scope.
Before:
```php
$client->extra_context(array('foo' => 'bar'));
```
After:
```php
use Sentry\State\Hub;
use Sentry\State\Scope;
Hub::getCurrent()->configureScope(function (Scope $scope): void {
$scope->setExtra('extra_key', 'extra_value');
});
```
- The method `Raven_Client::install` has been removed. The error handler is
registered automatically when using the `ExceptionListenerIntegration`
and `ErrorListenerIntegration` integrations (which are enabled by default).
### Processors
- The `Raven_Processor_RemoveCookiesProcessor` class has been removed.
- The `Raven_Processor_SanitizeStacktraceProcessor` class has been removed.
- The `Raven_Processor_SanitizeHttpHeadersProcessor` class has been removed.
- The `Raven_Processor_RemoveHttpBodyProcessor` class has been removed.
- The `Raven_Processor_SanitizeDataProcessor` class has been removed.
- The `Raven_Processor` class has been removed.
### Context
- The `Raven_Context` class has been renamed to `Context`.
- The `tags`, `extra` and `user` properties of the `Raven_Context` class have
been removed. Each instance of the new class represents now a single context
type at once.
## Error handlers
- The `Raven_Breadcrumbs_ErrorHandler` class has been removed.
- The `Raven_Breadcrumbs_MonologHandler` class has been removed.
- The `Raven_ErrorHandler` class has been renamed to `ErrorHandler` and has
been made `final`.
- The method `Raven_ErrorHandler::handleError` has changed its signature by removing
the `$context` argument and it has been marked as `internal` to make it clear that
it should not be called publicly and its method visibility is subject to changes
without any notice.
- The methods `Raven_ErrorHandler::registerErrorHandler`, `Raven_ErrorHandler::registerExceptionHandler`
and `Raven_ErrorHandler::registerShutdownFunction` have been removed. You should
use the `ErrorHandler::register` method instead, but note that it registers all
error handlers (error, exception and fatal error) at once and there is no way
anymore to only use one of them.
Before:
```php
$errorHandler = new Raven_ErrorHandler($client);
$errorHandler->registerErrorHandler();
$errorHandler->registerExceptionHandler();
$errorHandler->registerShutdownFunction();
```
After:
```php
use Sentry\ErrorHandler;
ErrorHandler::register(function (\Throwable $exception): void {
// ...
});
```
- The method `Raven_ErrorHandler::handleError` has changed its signature by
removing the `$context` argument and it has been marked as `internal` to
make it clear that it should not be called publicly and its method visibility
is subject to changes without any notice.
- The method `Raven_ErrorHandler::handleFatalError` has changed its signature
by adding an optional argument named `$error` and it has been marked as `internal`
to make it clear that it should not be called publicly and its method visibility
is subject to changes without any notice.
- The method `Raven_ErrorHandler::handleException` has changed its signature by
removing the `$isError` and `$vars` arguments and it has been marked as `internal`
to make it clear that it should not be called publicly and its method visibility
is subject to changes without any notice.
- The method `Raven_ErrorHandler::bitwiseOr` has been removed and there is no
replacement for it.
- The method `Raven_ErrorHandler::shouldCaptureFatalError` has been removed and
there is no replacement for it.
### Serializers
- The `Raven_Serializer` class has been renamed to `Serializer` and its constructor
changed signature.
Before:
```php
public function __construct($mb_detect_order = null, $message_limit = null)
{
// ...
}
```
After:
```php
public function __construct(int $maxDepth = 3, ?string $mbDetectOrder = null, int $messageLimit = Client::MESSAGE_MAX_LENGTH_LIMIT)
{
// ...
}
```
- The `Raven_ReprSerializer` class has been renamed to `RepresentationSerializer`
and its constructor changed signature.
Before:
```php
public function __construct($mb_detect_order = null, $message_limit = null)
{
// ...
}
```
After:
```php
public function __construct(int $maxDepth = 3, ?string $mbDetectOrder = null, int $messageLimit = Client::MESSAGE_MAX_LENGTH_LIMIT)
{
// ...
}
```