coedevtech/fixit

A Laravel package that captures and logs all exceptions into a database table — with optional encryption, email alerts, and a powerful CLI interface. Designed to give you full visibility into unhandled errors, without clutter or guesswork

This package's canonical repository appears to be gone and the package has been frozen as a result. Email us for help if needed.

v1.9.0 2025-06-19 10:50 UTC

Requires

• php: ^8.0|^8.1|^8.2|^8.3
• illuminate/support: ^9.0|^10.0|^11.0|^12.0

Requires (Dev)

• illuminate/database: ^9.0|^10.0|^11.0
• orchestra/testbench: *
• pestphp/pest: ^3.8
• pestphp/pest-plugin-laravel: ^3.2

MIT

• onyiimesi

• logging
• debugging
• laravel
• error logger
• exception logger
• fixit

README

fixIt is a Laravel package that captures and logs all exceptions into a database table — with optional encryption, email or Slack alerts, and a powerful CLI interface. Designed to give you full visibility into unhandled errors, without clutter or guesswork.

🚀 Features

• ✅ Logs all unhandled exceptions to the database
• 🔐 Optional field-level encryption using Laravel Crypt
• 📧 Multi-recipient email alerts support
• ⚙️ Configurable notification system (email + Slack supported)
• 🧠 AI-powered fix suggestions (optional)
• 🌪️ Built-in Pest tests
• 📊 Artisan CLI: fixit:report to view, filter, and fix errors
• ✍️ fixit:sync-config to merge missing config keys
• 🛠️ fixit:sync-migrations to publish and run package migrations
• 🧪 fixit:verify-config to validate and auto-patch .env
• 💡 Extensible alert interface (plug your own Discord, webhook, etc.)

🧩 Requirements

Dependency	Version
PHP	^8.1, ^8.2, or ^8.3
Laravel	^10.x, ^11.x, or ^12.x

📦 Installation

composer require coedevtech/fixit

Then publish and install:

php artisan fixit:install

During installation, you’ll be prompted to enable encryption (optional). If enabled, a FIXIT_ENCRYPTION_KEY will be added to your .env file.

⚙️ Configuration

Publish the configuration file:

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

To check for missing config keys later, run:

php artisan fixit:sync-config

To verify and auto-patch missing .env keys:

php artisan fixit:verify-config
php artisan fixit:verify-config --fix

To automatically append missing keys using short [] array syntax:

php artisan fixit:sync-config --write

For JSON output (CI pipelines):

php artisan fixit:verify-config --json

🔐 Manual Encryption / Decryption

fixIt provides two static methods via its facade to manually encrypt or decrypt data:

Encrypt data

use Fixit\Facades\Fixit;

$encrypted = Fixit::encrypt(['email' => '[e-mail]']);

This encrypts any string or array using AES-256-CBC with a secure IV and stores it base64-encoded.

Decrypt data

$decrypted = Fixit::decrypt($encrypted);

This will return the original value (array or string), decrypted securely.

🗃️ Database Table

Includes fields like:

• id
• url
• request
• response
• ip
• exception
• file
• line
• trace
• fingerprint
• occurrences
• last_seen_at
• environment
• status (not_fixed, fixed)
• created_at, updated_at

Table name is not configurable.

⚒️ Publishing Migrations

To publish and run any new package-provided migrations (e.g. adding new columns):

php artisan fixit:sync-migrations

This ensures that columns like fingerprint, last_seen_at, and occurrences are always present.

📧 Email Notifications

To receive an email when an error is logged:

1. Set send_on_error to true
2. Set the notifications.email in the config file
3. Ensure Laravel mail is properly configured

🧠 If you're using QUEUE_CONNECTION=database or QUEUE_CONNECTION=redis, you must run:

php artisan queue:work

Otherwise, queued emails will not be sent and may block request execution depending on your queue setup.

Configure in .env:

FIXIT_SEND_EMAIL=true
FIXIT_NOTIFICATION_EMAIL=[e-mail],[e-mail]
FIXIT_ALLOW_MULTIPLE_EMAILS=true

Emails will be sent to all valid addresses if FIXIT_ALLOW_MULTIPLE_EMAILS is true.

🧠 AI Suggestions (Optional)

fixIt supports AI-powered suggestions for fixing logged errors. This is completely optional.

Enable AI-powered suggestions:

FIXIT_AI_ENABLED=true
FIXIT_AI_API_KEY=sk-xxx    # or use FIXIT_AI_API_URL
FIXIT_AI_PROVIDER=openai   # or fixit-proxy, groq, etc.
FIXIT_AI_MODEL=gpt-3.5-turbo # or gpt-4 based on your provider
FIXIT_AI_API_URL=https://www.proxy-url.com # Used for fixit-proxy

If enabled, suggestions are included in:

• 📧 Email alerts
• 💬 Slack alerts
• Future CLI/reporting support

🧪 Running Tests

./vendor/bin/pest

All tests are written using Pest and cover encryption, logging, config, and notifications.

🖥️ CLI Usage

View error logs:

php artisan fixit:report

Filter errors:

php artisan fixit:report --status=fixed
php artisan fixit:report --all

Mark error as fixed:

php artisan fixit:report --fix=3

Sync and patch your config file:

php artisan fixit:sync-config          # show missing keys
php artisan fixit:sync-config --write  # append missing keys to config/fixit.php

Publish and apply package migrations:

php artisan fixit:sync-migrations

🔌 Extending Alerts

You can bind your own alert channel by implementing the Fixit\Contracts\FixitAlertInterface.

Example for Slack, Discord, or webhook alerts:

use Fixit\Contracts\FixitAlertInterface;

class SlackAlert implements FixitAlertInterface {
    public function send(string $message, ?Throwable $exception = null, ?string $suggestion = null): void {
        // Your logic here
    }
}

Then bind it in a service provider:

app()->bind(FixitAlertInterface::class, SlackAlert::class);

🛡️ Security & Best Practices

• Uses Laravel’s encryption system
• Avoids session or user tracking by default
• Decoupled and test-driven design
• Ready to extend with custom drivers or UI layers

📝 Changelog

See Releases for full changelog.