Download the PHP package coedevtech/fixit without Composer

🛠️ fixIt – Laravel Error Logging & Notification Package

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

📦 Installation

Then publish and 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:

To check for missing config keys later, run:

To verify and auto-patch missing .env keys:

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

For JSON output (CI pipelines):

🔐 Manual Encryption / Decryption

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

Encrypt data

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

Decrypt data

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):

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:

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

Configure in .env:

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:

If enabled, suggestions are included in:

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

🧪 Running Tests

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

🖥️ CLI Usage

View error logs:

Filter errors:

Mark error as fixed:

Sync and patch your config file:

Publish and apply package migrations:

🔌 Extending Alerts

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

Example for Slack, Discord, or webhook alerts:

Then bind it in a service provider:

🛡️ 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.