Download the PHP package compono-kit/error-handlers without Composer
On this page you can find all versions of the php package compono-kit/error-handlers. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download compono-kit/error-handlers
More information about compono-kit/error-handlers
Files in compono-kit/error-handlers
Package error-handlers
Short Description Interfaces for error handlers and an error handler delegator
License proprietary
Informations about the package error-handlers
ErrorHandlers
Provides a common interface for error handlers, a delegator that routes events to multiple handlers based on minimum severity, and a trait to inject error handlers into your own classes.
Installation
Concepts
HandlesErrors — the interface every handler implements
Any concrete handler (Sentry, file logger, Slack alert, …) implements this interface:
ErrorHandlerDelegator — route events to multiple handlers
Register each handler with a minimum severity level. The handler is only called for events at or above that level.
Now when you report events:
Severity order from lowest to highest: WARNING → ERROR → CRITICAL → ALERT → EMERGENCY
$context and $tags
Both parameters are array<string, string> — flat maps of string keys to string values. Do not pass nested arrays, objects, or other complex types, as concrete handler implementations (Sentry, log files, etc.) cannot reliably serialize them.
Exceptions with an explicit severity
exception() accepts an optional ErrorLevel parameter (defaults to EMERGENCY).
This controls which handlers receive the event — useful when not every exception is critical:
ErrorHandlerAware + ProvidingErrorHandler — inject a handler into your services
Use the interface and trait to make any class accept an error handler. If no handler is injected, a NullErrorHandler is used silently — no errors, no crashes.
Without injecting a handler the service works silently:
Inject the delegator when you want real reporting:
NullErrorHandler
NullErrorHandler is a no-op implementation of HandlesErrors. It is the default handler in ProvidingErrorHandler and can also be used explicitly in tests or environments where error reporting is not needed.