PHPackages                             spatie/symfony-ignition-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 &amp; Profiling](/categories/debugging)
4. /
5. spatie/symfony-ignition-bundle

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

spatie/symfony-ignition-bundle
==============================

A beautiful error page for Symfony apps

1.3.0(3mo ago)2919.5k↓24.1%6[1 PRs](https://github.com/spatie/symfony-ignition-bundle/pulls)MITPHPPHP ^8.1CI passing

Since Jan 26Pushed 3mo ago3 watchersCompare

[ Source](https://github.com/spatie/symfony-ignition-bundle)[ Packagist](https://packagist.org/packages/spatie/symfony-ignition-bundle)[ Docs](https://github.com/spatie/symfony-ignition-bundle)[ GitHub Sponsors](https://github.com/spatie)[ RSS](/packages/spatie-symfony-ignition-bundle/feed)WikiDiscussions main Synced 1mo ago

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

A beautiful error page for Symfony apps
=======================================

[](#a-beautiful-error-page-for-symfony-apps)

[![Latest Version on Packagist](https://camo.githubusercontent.com/1a2e114031b8729c277f5dd2cc941ddd94b0ca30fcd0cae122f98ae202cec3e2/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f7370617469652f73796d666f6e792d69676e6974696f6e2d62756e646c652e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/spatie/symfony-ignition-bundle)[![Tests](https://github.com/spatie/symfony-ignition-bundle/actions/workflows/run-tests.yml/badge.svg?branch=main)](https://github.com/spatie/symfony-ignition-bundle/actions/workflows/run-tests.yml)[![Total Downloads](https://camo.githubusercontent.com/95f1e5665a754c47ea653438d12f8f08a2699dfff57b53691333cbe69a19c9a4/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f7370617469652f73796d666f6e792d69676e6974696f6e2d62756e646c652e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/spatie/symfony-ignition-bundle)

[Ignition](https://github.com/spatie/ignition) is a beautiful and customizable error page for PHP applications

Using this bundle, you can replace Symfony's default exception pages with Ignition.

This is what how the Ignition looks like in the browser.

[![Screenshot of ignition](https://camo.githubusercontent.com/54b4d70285e561f1ac70b0ffb6d6cb7f1fb7728205ff1aa79ccb8e669deea9a4/68747470733a2f2f7370617469652e6769746875622e696f2f69676e6974696f6e2f69676e6974696f6e2e706e67)](https://camo.githubusercontent.com/54b4d70285e561f1ac70b0ffb6d6cb7f1fb7728205ff1aa79ccb8e669deea9a4/68747470733a2f2f7370617469652e6769746875622e696f2f69676e6974696f6e2f69676e6974696f6e2e706e67)

There's also a beautiful dark mode.

[![Screenshot of ignition in dark mode](https://camo.githubusercontent.com/beb274cfa365d6c667b5e62a57099628a5173eac0737755c0a4324b8708deb47/68747470733a2f2f7370617469652e6769746875622e696f2f69676e6974696f6e2f69676e6974696f6e2d6461726b2e706e67)](https://camo.githubusercontent.com/beb274cfa365d6c667b5e62a57099628a5173eac0737755c0a4324b8708deb47/68747470733a2f2f7370617469652e6769746875622e696f2f69676e6974696f6e2f69676e6974696f6e2d6461726b2e706e67)

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

[](#support-us)

[![](https://camo.githubusercontent.com/b0339890dcf00eec88c93e9fbc6af6e0f02d1366ff9922daf5fb1c04f438f63e/68747470733a2f2f6769746875622d6164732e73332e65752d63656e7472616c2d312e616d617a6f6e6177732e636f6d2f73796d666f6e792d69676e6974696f6e2d62756e646c652e6a70673f743d31)](https://spatie.be/github-ad-click/symfony-ignition-bundle)

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/symfony-ignition-bundle
```

Enable the bundle in `config/bundles.php`:

```
 return [
     // ...
+    Spatie\SymfonyIgnitionBundle\IgnitionBundle::class => ['dev' => true],
 ];
```

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

[](#configuration)

Use `bin/console debug:config ignition` to see configuration options.

`config/packages/ignition.yaml`:

```
when@dev:
    ignition:
        application_path: '%kernel.project_dir%'
        dark_mode: false
        should_display_exception: '%kernel.debug%'
        # when true, Ignition renders HTML errors even for non-HTML requests (e.g. JSON API routes)
        force_html_response: false
        # if you want AI solutions to your app's errors
        openai_key: 'key-here'
```

Usage
-----

[](#usage)

When you now throw an exception anywhere in your app...

```
class IndexController extends AbstractController
{
    #[Route('/', name: 'index')]
    public function index(): Response
    {
        throw new Exception('Hello Ignition!');
    }
}
```

... you'll see a beautiful error page.

[![screenshot](https://camo.githubusercontent.com/24495de227def42921a7c755a18831e80dd01a3fb010fa57fbfd64aab05d61f8/68747470733a2f2f7370617469652e6769746875622e696f2f73796d666f6e792d69676e6974696f6e2d62756e646c652f696d616765732f69676e6974696f6e2e706e67)](https://camo.githubusercontent.com/24495de227def42921a7c755a18831e80dd01a3fb010fa57fbfd64aab05d61f8/68747470733a2f2f7370617469652e6769746875622e696f2f73796d666f6e792d69676e6974696f6e2d62756e646c652f696d616765732f69676e6974696f6e2e706e67)

To learn all the options that Ignition provides, including error reporting to [Flare](https://flareapp.io), head over to [the readme of spatie/ignition](https://github.com/spatie/ignition#usage).

Testing
-------

[](#testing)

```
composer test
```

Changelog
---------

[](#changelog)

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

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

[](#contributing)

Please see [CONTRIBUTING](https://github.com/spatie/.github/blob/main/CONTRIBUTING.md) for details.

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

[](#security-vulnerabilities)

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

Credits
-------

[](#credits)

- [Andrew MacRobert](https://github.com/amacrobert)
- [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

54

—

FairBetter than 97% of packages

Maintenance82

Actively maintained with recent releases

Popularity39

Limited adoption so far

Community20

Small or concentrated contributor base

Maturity63

Established project with proven stability

 Bus Factor2

2 contributors hold 50%+ of commits

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

Total

7

Last Release

90d ago

Major Versions

0.0.3 → 1.0.02023-09-06

PHP version history (2 changes)0.0.1PHP ^8.0

1.1.0PHP ^8.1

### Community

Maintainers

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

---

Top Contributors

[![amacrobert](https://avatars.githubusercontent.com/u/1427361?v=4)](https://github.com/amacrobert "amacrobert (30 commits)")[![freekmurze](https://avatars.githubusercontent.com/u/483853?v=4)](https://github.com/freekmurze "freekmurze (25 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (22 commits)")[![github-actions[bot]](https://avatars.githubusercontent.com/in/15368?v=4)](https://github.com/github-actions[bot] "github-actions[bot] (15 commits)")[![thecaliskan](https://avatars.githubusercontent.com/u/13554944?v=4)](https://github.com/thecaliskan "thecaliskan (4 commits)")[![AdrianMrn](https://avatars.githubusercontent.com/u/12762044?v=4)](https://github.com/AdrianMrn "AdrianMrn (4 commits)")[![AlexVanderbist](https://avatars.githubusercontent.com/u/6287961?v=4)](https://github.com/AlexVanderbist "AlexVanderbist (2 commits)")[![Nelwhix](https://avatars.githubusercontent.com/u/58360242?v=4)](https://github.com/Nelwhix "Nelwhix (2 commits)")[![mrunkel](https://avatars.githubusercontent.com/u/3205232?v=4)](https://github.com/mrunkel "mrunkel (1 commits)")[![Nielsvanpach](https://avatars.githubusercontent.com/u/10651054?v=4)](https://github.com/Nielsvanpach "Nielsvanpach (1 commits)")[![SirMishaa](https://avatars.githubusercontent.com/u/42717232?v=4)](https://github.com/SirMishaa "SirMishaa (1 commits)")[![diimpp](https://avatars.githubusercontent.com/u/870747?v=4)](https://github.com/diimpp "diimpp (1 commits)")

---

Tags

spatiesymfony-ignition-bundle

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/spatie-symfony-ignition-bundle/health.svg)

```
[![Health](https://phpackages.com/badges/spatie-symfony-ignition-bundle/health.svg)](https://phpackages.com/packages/spatie-symfony-ignition-bundle)
```

###  Alternatives

[symfony/framework-bundle

Provides a tight integration between Symfony components and the Symfony full-stack framework

3.6k235.4M9.7k](/packages/symfony-framework-bundle)[symfony/security-bundle

Provides a tight integration of the Security component into the Symfony full-stack framework

2.5k172.9M1.8k](/packages/symfony-security-bundle)[sylius/sylius

E-Commerce platform for PHP, based on Symfony framework.

8.4k5.6M651](/packages/sylius-sylius)[shopware/platform

The Shopware e-commerce core

3.3k1.5M3](/packages/shopware-platform)[sulu/sulu

Core framework that implements the functionality of the Sulu content management system

1.3k1.3M152](/packages/sulu-sulu)[prestashop/prestashop

PrestaShop is an Open Source e-commerce platform, committed to providing the best shopping cart experience for both merchants and customers.

9.0k15.4k](/packages/prestashop-prestashop)

PHPackages © 2026

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