README

AI-powered error monitoring for Laravel applications. Captures exceptions and sends them to the FixStack platform for automated root cause analysis.

Requirements

• PHP 8.1+
• Laravel 10, 11, or 12

Installation

composer require fixstack/laravel

The service provider is auto-discovered — no manual registration needed.

Configuration

1. Add your credentials to .env:

FIXSTACK_API_KEY=pk_your_api_key_here
FIXSTACK_ENDPOINT=https://app.fixstack.dev

1. (Optional) Publish the config file:

php artisan vendor:publish --tag=fixstack-config

1. Test the connection:

php artisan fixstack:test

Usage

The SDK automatically captures all unhandled exceptions. No code changes required.

Breadcrumbs

Track user actions leading up to an error:

use FixStack\Laravel\FixStack;

FixStack::breadcrumb('User clicked checkout', 'user-action');
FixStack::breadcrumb('Payment processing started', 'payment');
FixStack::breadcrumb('Stripe API called', 'http');

Breadcrumbs are attached to the next error that occurs and provide context for AI analysis.

What Gets Captured

Each error report includes:

• Exception: class name, message, full stack trace
• Request: URL, HTTP method, headers, body (sensitive fields redacted)
• User: authenticated user ID and email
• App: Laravel version, PHP version, environment
• Breadcrumbs: recent actions leading up to the error

Configuration Options

Ignored Exceptions

By default, the following exceptions are not reported:

• Illuminate\Auth\AuthenticationException
• Illuminate\Validation\ValidationException
• Symfony\Component\HttpKernel\Exception\NotFoundHttpException

Customize in config/fixstack.php:

'ignored_exceptions' => [
    \Illuminate\Auth\AuthenticationException::class,
    \Illuminate\Validation\ValidationException::class,
    \Symfony\Component\HttpKernel\Exception\NotFoundHttpException::class,
    \App\Exceptions\IgnoredException::class, // your own
],

Data Sanitization

Sensitive data is automatically redacted before sending. Configure patterns in config/fixstack.php:

// Headers containing these strings are redacted
'sanitize_headers' => ['authorization', 'cookie', 'x-api-key'],

// Body fields containing these strings are redacted
'sanitize_body' => ['password', 'token', 'secret', 'credit_card', 'ssn'],

Async vs Sync

Async (default): Errors are sent via a queued job. Zero performance impact on your application. Requires a queue worker running (php artisan queue:work).

Sync: Errors are sent immediately during the request. Useful for testing or when no queue is available. Set FIXSTACK_ASYNC=false.

License

MIT