inprovo / howler-client
Error tracking client for Howler - sends exceptions to your Howler server
Requires
- php: ^8.2
- guzzlehttp/guzzle: ^7.0
- illuminate/http: ^11.0|^12.0|^13.0
- illuminate/support: ^11.0|^12.0|^13.0
Requires (Dev)
None
Suggests
None
Provides
None
Conflicts
None
Replaces
None
README
Error tracking client voor Howler. Vangt automatisch exceptions op in je Laravel applicatie en stuurt ze naar je Howler server.
Installatie
composer require inprovo/howler-client
Setup
1. Login (eenmalig per machine)
php artisan howler:login
Voer je Howler e-mail en wachtwoord in. Credentials worden opgeslagen in ~/.howler/credentials.
2. Project koppelen
php artisan howler:init
Kies een bestaand project of maak een nieuw project aan. De command schrijft automatisch HOWLER_API_KEY en HOWLER_ENDPOINT naar je .env.
3. Testen
php artisan howler:test
Stuurt een test exception naar Howler om te bevestigen dat alles werkt.
Hoe het werkt
Na installatie registreert de package zich automatisch als exception reporter in Laravel. Elke onafgevangen exception wordt naar Howler gestuurd met:
- Exception class, message en code
- Stack trace met code snippets (20 regels rondom de fout)
- Affected files (alleen app frames)
- Request data (method, URL, headers, body, IP)
- User data (ID, email)
- Route info (name, action)
- SQL queries met timings
- Performance metrics (duration, memory, slow queries)
- Git commit hash
- Custom context en glows
Gebruik
Custom context
use Inprovo\HowlerClient\Facades\Howler; // Context toevoegen (beschikbaar bij volgende error) Howler::context(['tenant_id' => 123, 'plan' => 'premium']);
Glows (breadcrumbs)
Howler::glow('Payment initiated', ['amount' => 49.99, 'provider' => 'mollie']); Howler::glow('Webhook received', ['event' => 'payment.paid']);
Handmatig rapporteren
Howler::report(new \RuntimeException('Iets ging mis'));
Artisan Commands
Error management (voor Claude Code)
# Lijst van unresolved errors php artisan howler:errors # Volledige error details met stack trace en code php artisan howler:show {error_id} # Toon error en markeer als in progress php artisan howler:fix {error_id} # Markeer als resolved met optionele notitie php artisan howler:resolve {error_id} --note="Fixed null check in PaymentService"
Setup commands
php artisan howler:login # Authenticatie php artisan howler:logout # Verwijder credentials php artisan howler:init # Project koppelen php artisan howler:test # Test connectie php artisan howler:status # Toon configuratie en status
Configuratie
Publiceer de config (optioneel):
php artisan vendor:publish --tag=howler-config
.env variabelen
HOWLER_API_KEY=hwl_... # Automatisch ingevuld door howler:init HOWLER_ENDPOINT=https://howler.inprovo.nl/api/errors HOWLER_ENVIRONMENT=production # Standaard: APP_ENV HOWLER_SLOW_QUERY_THRESHOLD=100 # Milliseconden HOWLER_ENABLED=true # Zet op false om rapportage uit te schakelen
Config opties
// config/howler.php 'rate_limit' => 100, // Max errors per minuut 'max_queries' => 50, // Max queries per error 'max_logs' => 20, // Max log entries per error 'max_glows' => 30, // Max glows per error 'sanitize_keys' => [ // Keys die gefilterd worden 'password', 'token', 'secret', 'api_key', 'authorization', 'cookie', 'credit_card', ], 'ignore_exceptions' => [ // Exceptions die niet gerapporteerd worden // \Symfony\Component\HttpKernel\Exception\NotFoundHttpException::class, ],
Vereisten
- PHP 8.2+
- Laravel 11, 12 of 13
- Guzzle 7
CLAUDE.md snippet
Voeg dit toe aan de CLAUDE.md van je project:
## Howler Error Tracking Dit project is verbonden met Howler error tracking. ### Error fix workflow: 1. `php artisan howler:errors` voor openstaande errors 2. `php artisan howler:show {error_id}` voor details met code context 3. Analyseer stack trace en affected files 4. Fix de bug 5. `php artisan howler:resolve {error_id} --note="Beschrijving van de fix"`
Licentie
MIT