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(2mo ago)9773.5k—1.4%8[1 PRs](https://github.com/spatie/laravel-error-solutions/pulls)MITPHPPHP ^8.2CI passing

Since Jul 1Pushed 1mo 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 1mo ago

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

 [   ![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://camo.githubusercontent.com/74105e28e1e594ca2d2763f928ca232346c7b764d308f73c9ea619e19cfd13ab/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f7370617469652f6c61726176656c2d6572726f722d736f6c7574696f6e732f72756e2d74657374732e796d6c3f6272616e63683d6d61696e266c6162656c3d7465737473267374796c653d666c61742d737175617265)](https://github.com/spatie/laravel-error-solutions/actions?query=workflow%3Arun-tests+branch%3Amain)[![GitHub Code Style Action Status](https://camo.githubusercontent.com/608db6ee8e930e12841b162becbbc3d7013ce5ca3cd260bafc69a6c89bc65222/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f7370617469652f6c61726176656c2d6572726f722d736f6c7574696f6e732f6669782d7068702d636f64652d7374796c652d6973737565732e796d6c3f6272616e63683d6d61696e266c6162656c3d636f64652532307374796c65267374796c653d666c61742d737175617265)](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

57

—

FairBetter than 98% of packages

Maintenance88

Actively maintained with recent releases

Popularity47

Moderate usage in the ecosystem

Community20

Small or concentrated contributor base

Maturity58

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 72.5% 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

73d 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 (103 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (11 commits)")[![github-actions[bot]](https://avatars.githubusercontent.com/in/15368?v=4)](https://github.com/github-actions[bot] "github-actions[bot] (6 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/ignition

A beautiful error page for PHP applications.

511147.6M69](/packages/spatie-ignition)[spatie/laravel-error-share

Share your Laravel errors to Flare

43965.6k3](/packages/spatie-laravel-error-share)[spatie/laravel-data

Create unified resources and data transfer objects

1.8k28.9M627](/packages/spatie-laravel-data)[spatie/laravel-ray

Easily debug Laravel apps

31738.4M2.8k](/packages/spatie-laravel-ray)[spatie/laravel-health

Monitor the health of a Laravel application

86910.0M83](/packages/spatie-laravel-health)[spatie/laravel-sql-commenter

Add comments to SQL queries made by Laravel

1931.4M1](/packages/spatie-laravel-sql-commenter)

PHPackages © 2026

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