PHPackages                             spatie/laravel-error-solutions - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Debugging &amp; Profiling](/categories/debugging)
4. /
5. spatie/laravel-error-solutions

ActiveLibrary[Debugging &amp; Profiling](/categories/debugging)

spatie/laravel-error-solutions
==============================

Display solutions on the Laravel error page

1.1.0(4mo ago)101110.5k↑11.7%8[1 PRs](https://github.com/spatie/laravel-error-solutions/pulls)2MITPHPPHP ^8.2CI passing

Since Jul 1Pushed 1w ago2 watchersCompare

[ Source](https://github.com/spatie/laravel-error-solutions)[ Packagist](https://packagist.org/packages/spatie/laravel-error-solutions)[ Docs](https://github.com/spatie/laravel-error-solutions)[ GitHub Sponsors](https://github.com/Spatie)[ RSS](/packages/spatie-laravel-error-solutions/feed)WikiDiscussions main Synced 3d ago

READMEChangelog (7)Dependencies (32)Versions (10)Used By (2)

 [   ![Logo for laravel-error-solutions](https://camo.githubusercontent.com/dfe33639d805970ed0bcf335042aba2e5954522cd17da0607163949af921a1b2/68747470733a2f2f7370617469652e62652f7061636b616765732f6865616465722f6c61726176656c2d6572726f722d736f6c7574696f6e732f68746d6c2f6c696768742e77656270)  ](https://spatie.be/open-source?utm_source=github&utm_medium=banner&utm_campaign=laravel-error-solutions) Display solutions on the Laravel error page
============================================

[](#-display-solutions-on-the-laravel-error-page)

[![Latest Version on Packagist](https://camo.githubusercontent.com/c50e46e4bda751d90ef87995cb0a88a4a8c6e762f942311d8b82bad451f5f8fe/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f7370617469652f6c61726176656c2d6572726f722d736f6c7574696f6e732e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/spatie/laravel-error-solutions)[![GitHub Tests Action Status](https://github.com/spatie/laravel-error-solutions/actions/workflows/run-tests.yml/badge.svg)](https://github.com/spatie/laravel-error-solutions/actions?query=workflow%3Arun-tests+branch%3Amain)[![GitHub Code Style Action Status](https://github.com/spatie/laravel-error-solutions/actions/workflows/fix-php-code-style-issues.yml/badge.svg)](https://github.com/spatie/laravel-error-solutions/actions?query=workflow%3A%22Fix+PHP+code+style+issues%22+branch%3Amain)[![Total Downloads](https://camo.githubusercontent.com/e58036fb402cfa3e1c7cee2e344bc32909387767927f76f8e344b2d411d005ba/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f7370617469652f6c61726176656c2d6572726f722d736f6c7574696f6e732e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/spatie/laravel-error-solutions)

This package can display solutions on the Laravel error page. Here's how it looks:

[![image](https://raw.githubusercontent.com/spatie/laravel-error-solutions/main/docs/images/solution.png)](https://raw.githubusercontent.com/spatie/laravel-error-solutions/main/docs/images/solution.png)

For some solutions, the package will display a button that will automatically run the solution. Here's how that looks when you forget to set an `APP_KEY` in your `.env` file:

[![image](https://raw.githubusercontent.com/spatie/laravel-error-solutions/main/docs/images/runnable-solution.png)](https://raw.githubusercontent.com/spatie/laravel-error-solutions/main/docs/images/runnable-solution.png)

Support us
----------

[](#support-us)

[![](https://camo.githubusercontent.com/7f05f1259e5fa8867650b33e2090e45891ac22ccb519eb6862d0ba2d27bf9471/68747470733a2f2f6769746875622d6164732e73332e65752d63656e7472616c2d312e616d617a6f6e6177732e636f6d2f6c61726176656c2d6572726f722d736f6c7574696f6e732e6a70673f743d31)](https://spatie.be/github-ad-click/laravel-error-solutions)

We invest a lot of resources into creating [best in class open source packages](https://spatie.be/open-source). You can support us by [buying one of our paid products](https://spatie.be/open-source/support-us).

We highly appreciate you sending us a postcard from your hometown, mentioning which of our package(s) you are using. You'll find our address on [our contact page](https://spatie.be/about-us). We publish all received postcards on [our virtual postcard wall](https://spatie.be/open-source/postcards).

Installation
------------

[](#installation)

You can install the package via composer:

```
composer require --dev spatie/laravel-error-solutions
```

You can publish the config file with:

```
php artisan vendor:publish --tag="error-solutions-config"
```

This is the contents of the published config file:

```
return [
    /**
     * Display solutions on the error page
     */
    'enabled' => true,

    /**
     * Enable or disable runnable solutions.
     *
     * Runnable solutions will only work in local development environments,
     * even if this flag is set to true.
     */
    'enable_runnable_solutions' => true,

    /**
     * This class is responsible for determining if a solution is runnable.
     *
     * In most cases, you can use the default implementation.
     */
    'runnable_solutions_guard' => Spatie\LaravelErrorSolutions\Support\RunnableSolutionsGuard::class,
];
```

Optionally, you can publish the views using

```
php artisan vendor:publish --tag="error-solutions-views"
```

Usage
-----

[](#usage)

You can find full documentation on how to use this package on [our documentation site](https://spatie.be/docs/laravel-error-solutions/v1/introduction).

Testing
-------

[](#testing)

```
composer test
```

Changelog
---------

[](#changelog)

Please see [CHANGELOG](CHANGELOG.md) for more information on what has changed recently.

Contributing
------------

[](#contributing)

Please see [CONTRIBUTING](CONTRIBUTING.md) for details.

Security Vulnerabilities
------------------------

[](#security-vulnerabilities)

Please review [our security policy](../../security/policy) on how to report security vulnerabilities.

Credits
-------

[](#credits)

- [Freek Van der Herten](https://github.com/freekmurze)
- [All Contributors](../../contributors)

License
-------

[](#license)

The MIT License (MIT). Please see [License File](LICENSE.md) for more information.

###  Health Score

58

—

FairBetter than 98% of packages

Maintenance89

Actively maintained with recent releases

Popularity48

Moderate usage in the ecosystem

Community25

Small or concentrated contributor base

Maturity59

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 71.4% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~102 days

Recently: every ~120 days

Total

7

Last Release

120d ago

Major Versions

0.0.1 → 1.0.02024-07-01

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/7535935?v=4)[Spatie](/maintainers/spatie)[@spatie](https://github.com/spatie)

---

Top Contributors

[![freekmurze](https://avatars.githubusercontent.com/u/483853?v=4)](https://github.com/freekmurze "freekmurze (105 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (13 commits)")[![github-actions[bot]](https://avatars.githubusercontent.com/in/15368?v=4)](https://github.com/github-actions[bot] "github-actions[bot] (7 commits)")[![getJv](https://avatars.githubusercontent.com/u/2864961?v=4)](https://github.com/getJv "getJv (5 commits)")[![sebastiandedeyne](https://avatars.githubusercontent.com/u/1561079?v=4)](https://github.com/sebastiandedeyne "sebastiandedeyne (3 commits)")[![imliam](https://avatars.githubusercontent.com/u/4326337?v=4)](https://github.com/imliam "imliam (3 commits)")[![jimirobaer](https://avatars.githubusercontent.com/u/8984769?v=4)](https://github.com/jimirobaer "jimirobaer (3 commits)")[![AlexVanderbist](https://avatars.githubusercontent.com/u/6287961?v=4)](https://github.com/AlexVanderbist "AlexVanderbist (2 commits)")[![riasvdv](https://avatars.githubusercontent.com/u/3626559?v=4)](https://github.com/riasvdv "riasvdv (2 commits)")[![laravel-shift](https://avatars.githubusercontent.com/u/15991828?v=4)](https://github.com/laravel-shift "laravel-shift (1 commits)")[![paulredmond](https://avatars.githubusercontent.com/u/177773?v=4)](https://github.com/paulredmond "paulredmond (1 commits)")[![cord](https://avatars.githubusercontent.com/u/158588?v=4)](https://github.com/cord "cord (1 commits)")[![helderneves91](https://avatars.githubusercontent.com/u/11777337?v=4)](https://github.com/helderneves91 "helderneves91 (1 commits)")

---

Tags

errorlaravelsolutionsspatielaraveldeverrorsflarelaravel-error-solutions

###  Code Quality

TestsPest

Static AnalysisPHPStan

Code StyleLaravel Pint

### Embed Badge

![Health badge](/badges/spatie-laravel-error-solutions/health.svg)

```
[![Health](https://phpackages.com/badges/spatie-laravel-error-solutions/health.svg)](https://phpackages.com/packages/spatie-laravel-error-solutions)
```

###  Alternatives

[spatie/laravel-permission

Permission handling for Laravel 12 and up

12.9k102.4M1.4k](/packages/spatie-laravel-permission)[spatie/laravel-pdf

Create PDFs in Laravel apps

1.0k4.8M47](/packages/spatie-laravel-pdf)[dedoc/scramble

Automatic generation of API documentation for Laravel applications.

2.1k11.2M100](/packages/dedoc-scramble)[spatie/laravel-passkeys

Use passkeys in your Laravel app

471890.7k39](/packages/spatie-laravel-passkeys)[spatie/laravel-health

Monitor the health of a Laravel application

87512.0M165](/packages/spatie-laravel-health)[spatie/laravel-error-share

Share your Laravel errors to Flare

431.4M6](/packages/spatie-laravel-error-share)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
