fixstack/laravel

Laravel SDK for FixStack — AI-powered error monitoring and debugging

dev-master 2026-02-14 09:51 UTC

Requires

• php: ^8.1
• illuminate/http: ^10.0|^11.0|^12.0
• illuminate/queue: ^10.0|^11.0|^12.0
• illuminate/support: ^10.0|^11.0|^12.0

MIT

• exceptions
• debugging
• laravel
• ai
• error-monitoring

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

Option	Env Variable	Default	Description
enabled	FIXSTACK_ENABLED	true	Enable/disable error reporting
endpoint	FIXSTACK_ENDPOINT	https://app.fixstack.dev	Platform API URL
api_key	FIXSTACK_API_KEY	—	Project API key (from Settings)
async	FIXSTACK_ASYNC	true	Send errors via queue (recommended)
queue_connection	FIXSTACK_QUEUE	null	Queue connection (null = default)
sample_rate	FIXSTACK_SAMPLE_RATE	1.0	0.0–1.0, percentage of errors to report
environments	—	['production', 'staging']	Only report in these environments
timeout	—	5	HTTP timeout in seconds

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