dmn/laravel-exception

Exceptions for Larave 10+

v1.1.0 2025-07-25 09:28 UTC

Requires (Dev)

• laravel/framework: ^12.21
• orchestra/testbench: ^10.4
• squizlabs/php_codesniffer: ^3.13

MIT

• dc

README

composer require dmn/laravel-exception

Usage

Extend Dmn\Exceptions\Handler to your app/Exceptions/Handler.php and add parent::register() to your register().

<?php

namespace App\Exceptions;

use Dmn\Exceptions\Handler as ExceptionHandler;
use Throwable;

class Handler extends ExceptionHandler
{
...
    /**
     * Register the exception handling callbacks for the application.
     */
    public function register(): void
    {
        parent::register();
        $this->reportable(function (Throwable $e) {
            //
        });
    }
...
}

To add more custom exceptions, add new exception by running php artisan make:exception and extend Dmn\Exceptions\Exception instead of \Exception. New exceptions need to have $code, $message and $httpStatusCode. You may add $description.

<?php

namespace App\Exceptions;

use Dmn\Exceptions\Exception;
use Illuminate\Http\Response;

class NewCustomException extends Exception
{
    protected $code = 'sample_error_code';

    protected $message = 'Sample error message';

    protected $httpStatusCode = Response::HTTP_BAD_REQUEST;

    protected $description = 'Sample more detailed error description.';
}

The above exception will render:

{
    status_code: 400,
    code: "sample_error_code",
    message: "Sample error message.",
    description: "Sample more details error description.",
}

To override other exceptions from other packages or from laravel itself, you can add it inside customException().

protected function customException(): void
{
    parent::customException();

    // your overrides here
    // example
    $this->renderable(function (\Vendor\Package\Exception $e) {
        throw new App\Exceptions\NewCustomException();
    });
}

Other usage option (not recommended)

You may use Dmn\Exceptions\Handler directly from your bootstrap/app.php

$app->singleton(
    Illuminate\Contracts\Debug\ExceptionHandler::class,
    // App\Exceptions\Handler::class <-- change this
    Dmn\Exceptions\Handler
);