debugmate/laravel

A package to help you tracking the project errors

1.0.0 2024-12-16 21:39 UTC

README

DebugMate is a beautiful error tracking package that will help your software team to track and fix errors.

Table Of Compatibility

Now you can install the package:

composer require debugmate/laravel

Run the following command to install the package files:

php artisan debugmate:install

Configuring DebugMate connection

After the installation, you should configure the connection with DebugMate main application. Open your .env file and check for this new env vars:

DEBUGMATE_DOMAIN=
DEBUGMATE_ENABLED=
DEBUGMATE_TOKEN=

DEBUGMATE_DOMAIN: You must set your DebugMate domain on this var. This way, our package will know where it should send the error data. If your DebugMate instance runs on a port different than the 80 or 443, you should add it too. E.g.: http://debugmate.mydomain.com:9001.

DEBUGMATE_ENABLED: With this var, you can control if DebugMate features will be available or not.

DEBUGMATE_TOKEN: On this var, you should set the project token. With this, you instruct DebugMate in which project the errors will be attached.

Reporting unhandled exceptions

You need to add the DebugMate as a log-channel by adding the following config to the channels section in config/logging.php:

'channels' => [
    // ...
    'debugmate' => [
        'driver' => 'debugmate',
    ],
],

After that you need to fill it on LOG_STACK env:

LOG_STACK=debugmate

Testing if everything works

By the end you're being able to send a fake exception to test connection

php artisan debugmate:test