PHPackages                             raffaelecarelle/php-error-insight-symfony-bundle - 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 & Profiling](/categories/debugging)
4. /
5. raffaelecarelle/php-error-insight-symfony-bundle

ActiveSymfony-bundle[Debugging & Profiling](/categories/debugging)

raffaelecarelle/php-error-insight-symfony-bundle
================================================

Symfony Bundle for PHP Error Insight - AI-powered error handling for Symfony applications

1.0.17(8mo ago)1702↓54.7%GPL-3.0-or-laterPHPPHP >=8.1CI passing

Since Sep 19Pushed 7mo ago1 watchersCompare

[ Source](https://github.com/raffaelecarelle/Php-Error-Insight-Symfony-Bundle)[ Packagist](https://packagist.org/packages/raffaelecarelle/php-error-insight-symfony-bundle)[ RSS](/packages/raffaelecarelle-php-error-insight-symfony-bundle/feed)WikiDiscussions main Synced yesterday

READMEChangelog (10)Dependencies (16)Versions (19)Used By (0)

PHP Error Insight Symfony Bundle
================================

[](#php-error-insight-symfony-bundle)

A Symfony bundle that integrates [PHP Error Insight](https://github.com/raffaelecarelle/php-error-insight) to provide AI‑assisted explanations and richer error pages for HTTP and Console errors.

Screenshots:

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

Features
--------

[](#features)

- 🔍 AI‑assisted error explanations (optional, multiple backends)
- 🎨 Enhanced HTML/text/JSON rendering provided by the core library
- ⚡ Seamless Symfony integration for HTTP exceptions and Console errors
- 🔧 Highly configurable: choose backend, model, output, verbosity and paths

Requirements
------------

[](#requirements)

- PHP >= 8.1
- Symfony >= 5.4
- Composer

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

[](#installation)

Install the bundle (typically in dev/test):

```
composer require --dev raffaelecarelle/php-error-insight-symfony-bundle
```

### Configure Symfony Runtime error handler (required)

[](#configure-symfony-runtime-error-handler-required)

To enable the bundle's PHP error handling, you must tell Symfony Runtime to use this bundle's error handler. Add the following to your application's `composer.json` under the `extra.runtime` section, then regenerate the autoloader:

```
{
  "extra": {
    "runtime": {
      "error_handler": "PhpErrorInsightBundle\\Handler\\ErrorHandler"
    }
  }
}
```

After editing composer.json, run:

```
composer dump-autoload
```

Notes:

- The configuration must live in your application root `composer.json` (not in a dependency).
- This requires the `symfony/runtime` Composer plugin to be allowed in your project (see `config.allow-plugins["symfony/runtime"]`).

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

[](#configuration)

The bundle exposes a single configuration root: `php_error_insight`.

### Basic configuration

[](#basic-configuration)

Create or update `config/packages/php_error_insight.yaml`:

```
php_error_insight:
    enabled: true
    backend: 'none'   # or: local, api, openai, anthropic, google, gemini
    language: 'en'
    output: 'auto'    # or: html, text, json
```

### Advanced configuration

[](#advanced-configuration)

```
php_error_insight:
    enabled: true
    backend: 'local'
    model: 'llama3:instruct'
    api_url: 'http://localhost:11434'
    language: 'en'
    output: 'html'
    verbose: false

    # Absolute path of your project inside the running environment
    # (e.g. "/app" inside a Docker container)
    project_root: '%kernel.project_dir%'

    # Optional: absolute path of the project on the host machine to map
    # container paths to host paths when rendering links
    host_root: '/absolute/path/on/host'

    # Optional: custom HTML template supported by the core library
    template: null

    # Optional: editor URL pattern, e.g. "phpstorm://open?file=%file%&line=%line%"
    editor_url: null

    # API key for external backends (openai, anthropic, google/gemini, custom api)
    api_key: null
```

Notes:

- `backend` supports: `none`, `local`, `api`, `openai`, `anthropic`, `google`, `gemini`.
- When using local backends (e.g. Ollama), set `api_url` to your local endpoint.
- Use `project_root` and optionally `host_root` to make editor links and paths resolve correctly across containers/hosts.
- `editor_url` placeholders supported by the core renderer are typically `%file%` and `%line%`.

### Environment variables

[](#environment-variables)

You can configure via environment variables as well (e.g. in `.env.local`):

```
PHP_ERROR_INSIGHT_ENABLED=true
PHP_ERROR_INSIGHT_BACKEND=local
PHP_ERROR_INSIGHT_MODEL=llama3:instruct
PHP_ERROR_INSIGHT_API_URL=http://localhost:11434
PHP_ERROR_INSIGHT_LANG=en
PHP_ERROR_INSIGHT_OUTPUT=html
PHP_ERROR_INSIGHT_VERBOSE=false
PHP_ERROR_INSIGHT_PROJECT_ROOT=/app
PHP_ERROR_INSIGHT_HOST_ROOT=/Users/you/Projects/acme
PHP_ERROR_INSIGHT_EDITOR="phpstorm://open?file=%file%&line=%line%"
PHP_ERROR_INSIGHT_API_KEY=your-key-if-needed
```

Backend configuration examples
------------------------------

[](#backend-configuration-examples)

### 1) Local AI (Ollama)

[](#1-local-ai-ollama)

```
php_error_insight:
    backend: 'local'
    model: 'llama3:instruct'
    api_url: 'http://localhost:11434'
```

### 2) OpenAI

[](#2-openai)

```
php_error_insight:
    backend: 'openai'
    model: 'gpt-4o-mini'
    api_key: 'sk-your-openai-api-key'
```

### 3) Anthropic Claude

[](#3-anthropic-claude)

```
php_error_insight:
    backend: 'anthropic'
    model: 'claude-3-5-sonnet-20240620'
    api_key: 'your-anthropic-api-key'
```

### 4) Google (Generative AI)

[](#4-google-generative-ai)

```
php_error_insight:
    backend: 'google'
    model: 'gemini-1.5-flash'
    api_key: 'your-google-api-key'
```

### 5) Gemini (alias backend)

[](#5-gemini-alias-backend)

```
php_error_insight:
    backend: 'gemini'
    model: 'gemini-1.5-flash'
    api_key: 'your-google-api-key'
```

Usage
-----

[](#usage)

### HTTP exceptions

[](#http-exceptions)

The bundle registers a high‑priority listener for `kernel.exception`. When `enabled` is true, exceptions are rendered using PHP Error Insight’s renderer. If rendering fails or produces empty output, Symfony’s default error handling is used.

### Console errors

[](#console-errors)

A console event subscriber listens to `ConsoleEvents::ERROR` and, when `enabled`, prints the rendered output to the console. If rendering fails or produces empty output, normal console error output is preserved.

### Programmatic usage

[](#programmatic-usage)

You can call the service directly:

```
use PhpErrorInsightBundle\Service\ErrorInsightService;

final class YourController
{
    public function __construct(private ErrorInsightService $errorInsightService) {}

    public function someAction(): Response
    {
        try {
            // ... your code
        } catch (\Throwable $e) {
            if ($this->errorInsightService->isEnabled()) {
                $html = $this->errorInsightService->renderException($e);
                // do something with $html (log, email, custom response, ...)
            }

            throw $e; // keep default handling flow
        }
    }
}
```

Service IDs:

- `PhpErrorInsightBundle\Service\ErrorInsightService` (autowired)
- Alias: `php_error_insight.service`

How it works
------------

[](#how-it-works)

1. Exception interception (HTTP) via `kernel.exception` listener
2. Error interception (Console) via `ConsoleEvents::ERROR` subscriber
3. The bundle builds a Config and delegates rendering to the core library
4. Graceful fallback to Symfony’s default error handling when needed

Environment considerations
--------------------------

[](#environment-considerations)

It’s recommended to enable the bundle only in `dev` and/or `test`. You control this through:

- `config/bundles.php` (register the bundle for specific environments)
- `php_error_insight.enabled` setting per environment config

Customization
-------------

[](#customization)

- `template`: path to a custom HTML template supported by the core renderer
- `editor_url`: URL pattern to open files in your editor (e.g. PhpStorm)
- `project_root` / `host_root`: map paths correctly between container and host

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

[](#troubleshooting)

- Ensure the bundle is registered for the environment you’re using
- Verify `php_error_insight.enabled` is true for that environment
- For local backends, ensure your local service (e.g. Ollama) is running
- For API backends, verify `api_key` and reachability of `api_url` if applicable
- Check your logs for errors from the renderer or backend

Development
-----------

[](#development)

Run tests:

```
composer install
composer test
```

Quality tools:

```
composer quality
composer fix-all
```

License
-------

[](#license)

This bundle is licensed under the GPL-3.0-or-later license. See [LICENSE](LICENSE) for details.

Related
-------

[](#related)

- [PHP Error Insight](https://github.com/raffaelecarelle/php-error-insight)
- [Symfony](https://symfony.com)

###  Health Score

38

—

LowBetter than 83% of packages

Maintenance63

Regular maintenance activity

Popularity19

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity53

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 ~3 days

Total

17

Last Release

243d ago

### 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 (77 commits)")

---

Tags

symfonybundleaidebuggingexception handlingerror handling

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan, Rector

Code StylePHP CS Fixer

Type Coverage Yes

### Embed Badge

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

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

###  Alternatives

[kimai/kimai

Kimai - Time Tracking

4.8k9.0k1](/packages/kimai-kimai)[shopware/core

Shopware platform is the core for all Shopware ecommerce products.

585.6M574](/packages/shopware-core)[rcsofttech/audit-trail-bundle

Enterprise-grade, high-performance Symfony audit trail bundle. Automatically track Doctrine entity changes with split-phase architecture, multiple transports (HTTP, Queue, Doctrine), and sensitive data masking.

1189.8k](/packages/rcsofttech-audit-trail-bundle)[sulu/skeleton

Project template for starting your new project based on the Sulu content management system

29735.5k](/packages/sulu-skeleton)[web-auth/webauthn-symfony-bundle

FIDO2/Webauthn Security Bundle For Symfony

66529.9k11](/packages/web-auth-webauthn-symfony-bundle)[ahmed-bhs/doctrine-doctor

Runtime analysis tool for Doctrine ORM integrated into Symfony Web Profiler. Unlike static linters, it analyzes actual query execution at runtime to detect performance bottlenecks, security vulnerabilities, and best practice violations during development with real execution context and data.

9410.8k](/packages/ahmed-bhs-doctrine-doctor)

PHPackages © 2026

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