PHPackages                             raffaelecarelle/php-error-insight-laravel - 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. raffaelecarelle/php-error-insight-laravel

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

raffaelecarelle/php-error-insight-laravel
=========================================

Laravel integration for PHP Error Insight (raffaelecarelle/php-error-insight)

1.0.0(6mo ago)10[1 PRs](https://github.com/raffaelecarelle/PhpErrorInsight-Laravel-Package/pulls)GPL-3.0-or-laterPHPPHP &gt;=8.2CI passing

Since Oct 23Pushed 4mo agoCompare

[ Source](https://github.com/raffaelecarelle/PhpErrorInsight-Laravel-Package)[ Packagist](https://packagist.org/packages/raffaelecarelle/php-error-insight-laravel)[ RSS](/packages/raffaelecarelle-php-error-insight-laravel/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (4)Dependencies (12)Versions (6)Used By (0)

PHP Error Insight — Laravel Package
===================================

[](#php-error-insight--laravel-package)

Integration package for Laravel that renders PHP Error Insight’s rich HTML error page (with AI-powered details and suggestions) during development.

- Core library: raffaelecarelle/php-error-insight
- Supports Laravel 9, 10, 11, 12 (requires PHP &gt;= 8.2)

Screenshots:

[![screenview1.png](resources/img/readme/screenview1.png)](resources/img/readme/screenview1.png)[![screenview2.png](resources/img/readme/screenview2.png)](resources/img/readme/screenview2.png)[![terminal.png](resources/img/readme/terminal.png)](resources/img/readme/terminal.png)

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

[](#installation)

```
composer require raffaelecarelle/php-error-insight-laravel --dev
```

Laravel 5.5+ package auto-discovery will register the service provider automatically. No manual changes are needed.

Configuration
-------------

[](#configuration)

Publish the config file to customize settings:

```
php artisan vendor:publish --tag=php-error-insight-config
```

Environment variables (same as the core library) are supported and merged with the package config:

- PHP\_ERROR\_INSIGHT\_ENABLED=true|false (default: true)
- PHP\_ERROR\_INSIGHT\_BACKEND=none|local|api|openai|anthropic|google|gemini
- PHP\_ERROR\_INSIGHT\_MODEL=llama3:instruct|gpt-4o-mini|claude-3-5-sonnet-20240620|gemini-1.5-flash
- PHP\_ERROR\_INSIGHT\_API\_KEY=... (when using API backends)
- PHP\_ERROR\_INSIGHT\_API\_URL=... (optional override)
- PHP\_ERROR\_INSIGHT\_LANG=it|en|...
- PHP\_ERROR\_INSIGHT\_OUTPUT=auto|html|text|json (web rendering forces html)
- PHP\_ERROR\_INSIGHT\_VERBOSE=true|false
- PHP\_ERROR\_INSIGHT\_TEMPLATE=/absolute/path/to/custom/template.php
- PHP\_ERROR\_INSIGHT\_ROOT=/absolute/path/to/project (used for relative paths and editor links)
- PHP\_ERROR\_INSIGHT\_HOST\_ROOT=/host/path (containers mapping)
- PHP\_ERROR\_INSIGHT\_EDITOR="vscode://file/%file:%line" or "phpstorm://open?file=%file&amp;line=%line"

How it works in Laravel
-----------------------

[](#how-it-works-in-laravel)

- The package decorates the framework ExceptionHandler to render the core library’s HTML page on errors and exceptions.
- Activation conditions:
    - App is in debug mode (config/app.php: 'debug' =&gt; true)
    - Request expects HTML (not JSON)
    - The feature is enabled (via env/config)
- For all other cases (JSON/API requests, production, disabled), Laravel’s default handler is used.

No changes are made to your app/Exceptions/Handler.php.

Editor links and stack features
-------------------------------

[](#editor-links-and-stack-features)

The HTML page supports clickable file links and clipboard helpers. Configure:

```
PHP_ERROR_INSIGHT_ROOT=/var/www/app
PHP_ERROR_INSIGHT_EDITOR="phpstorm://open?file=%file&line=%line"
# For containers mapping to host project path
PHP_ERROR_INSIGHT_HOST_ROOT=/Users/you/project
```

Version compatibility
---------------------

[](#version-compatibility)

- Package requires PHP &gt;= 8.1 (aligned with the core library)
- Tested path is compatible with Laravel 8, 9, 10, 11.
- Older Laravel versions that require PHP &lt; 8.1 are not supported by this package due to PHP constraints.

Disable in production
---------------------

[](#disable-in-production)

Set in .env:

```
APP_DEBUG=false
PHP_ERROR_INSIGHT_ENABLED=false
```

Troubleshooting
---------------

[](#troubleshooting)

- If you don’t see the custom HTML page:
    - Ensure APP\_DEBUG=true and request is in a browser (Accept: text/html)
    - Check that the package service provider is auto-discovered (config/app.php &gt; providers) or add it manually.
    - Ensure environment variables are loaded and not cached, or run `php artisan config:clear`.
    - Verify your AI backend configuration if you expect AI-generated details.

###  Health Score

35

—

LowBetter than 80% of packages

Maintenance72

Regular maintenance activity

Popularity2

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity51

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% 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 ~4 days

Total

4

Last Release

186d ago

Major Versions

0.0.3 → 1.0.02025-11-07

### Community

Maintainers

![](https://www.gravatar.com/avatar/470d7f2b64c268ccd0d73d1d19da604f5049ffdc717170df28ac460d34b8a327?d=identicon)[raffaelecarelle](/maintainers/raffaelecarelle)

---

Top Contributors

[![raffaelecarelle](https://avatars.githubusercontent.com/u/15015792?v=4)](https://github.com/raffaelecarelle "raffaelecarelle (31 commits)")

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan, Rector

Code StylePHP CS Fixer

Type Coverage Yes

### Embed Badge

![Health badge](/badges/raffaelecarelle-php-error-insight-laravel/health.svg)

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

###  Alternatives

[spatie/laravel-ray

Easily debug Laravel apps

31538.4M2.8k](/packages/spatie-laravel-ray)[spatie/laravel-honeypot

Preventing spam submitted through forms

1.6k6.0M60](/packages/spatie-laravel-honeypot)[proengsoft/laravel-jsvalidation

Validate forms transparently with Javascript reusing your Laravel Validation Rules, Messages, and FormRequest

1.1k2.3M49](/packages/proengsoft-laravel-jsvalidation)[illuminate/validation

The Illuminate Validation package.

18936.7M1.4k](/packages/illuminate-validation)[illuminate/session

The Illuminate Session package.

9937.4M753](/packages/illuminate-session)[moonshine/moonshine

Laravel administration panel

1.3k217.1k59](/packages/moonshine-moonshine)

PHPackages © 2026

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