Search by 
kuick / sentry
Kuick Sentry provides a bridge to Sentry for Kuick applications.
Maintainers
v2.2.1
2026-05-13 13:35 UTC
Requires
- php: >=8.2.0
- kuick/framework: ^2.3
- nyholm/dsn: ^2.0
- sentry/sentry: ^4.10
Requires (Dev)
- kuick/qa-toolkit: ^2.0
README
A Sentry bridge for applications based on Kuick Framework
Requirements
- PHP 8.2 or higher
- Kuick Framework
^2.3
Installation
1. Install via Composer
composer require kuick/sentry
2. Register the DI definitions
The DI file wires SentryConfig, SentryInitializer, SentryListener, and SentryExceptionController and reads all settings from environment variables.
Test out the Sentry exception trigger it with:
curl -X PUT https://your-app.example.com/api/sentry/exception
Check your Sentry project — an event titled "Test exception for sentry integration" should appear.
3. Configure via environment variables
| Variable | Default | Description |
|---|---|---|
SENTRY_ENABLED |
0 |
Set to 1 to enable Sentry reporting |
SENTRY_DSN |
(empty) | Your project DSN from the Sentry dashboard |
SENTRY_ENVIRONMENT |
LOCAL |
Environment tag sent with every event (e.g. production, staging) |
SENTRY_SAMPLE_RATE |
1.0 |
Traces sample rate between 0.0 and 1.0 |
SENTRY_RELEASE |
(empty) | Release identifier (e.g. v1.2.3 or a commit SHA) |
SENTRY_IGNORE_EXCEPTIONS |
Kuick\Http\HttpException |
Comma-separated list of exception class names that should not be reported |
Example .env file:
SENTRY_ENABLED=1 SENTRY_DSN=https://examplePublicKey@o0.ingest.sentry.io/0 SENTRY_ENVIRONMENT=production SENTRY_SAMPLE_RATE=1.0 SENTRY_RELEASE=v1.0.0 SENTRY_IGNORE_EXCEPTIONS=Kuick\Http\HttpException,App\Exception\ValidationException