jolicode / gif-exception-bundle

v1.12.0 2026-10-12 13:16 UTC

Requires

• php: >=8.2
• symfony/framework-bundle: ^6.4 || ^7.3 || ^8.0
• symfony/twig-bundle: ^6.4 || ^7.3 || ^8.0

Requires (Dev)

• friendsofphp/php-cs-fixer: ^3.17
• phpstan/phpstan: ^2.1
• phpunit/phpunit: ^11.5
• symfony/asset: ^6.4 || ^7.3 || ^8.0
• symfony/browser-kit: ^6.4 || ^7.3 || ^8.0
• symfony/config: ^6.4 || ^7.3 || ^8.0
• symfony/console: ^6.4 || ^7.3 || ^8.0
• symfony/dependency-injection: ^6.4 || ^7.3 || ^8.0
• symfony/error-handler: ^6.4 || ^7.3 || ^8.0
• symfony/http-kernel: ^6.4 || ^7.3 || ^8.0
• symfony/monolog-bundle: ^3.8 || ^4.0
• symfony/phpunit-bridge: ^7.3 || ^8.0
• symfony/stopwatch: ^6.4 || ^7.3 || ^8.0
• symfony/web-profiler-bundle: ^6.4 || ^7.3 || ^8.0
• symfony/yaml: ^6.4 || ^7.3 || ^8.0

MIT

• symfony
• exception
• random
• gif

Published on Packagist.org on 2026-10-12 13:17 UTC

README

The GhostBuster of your exception page!

It displays a GIF instead of Symfony's ghost on exception page and it's compatible with Symfony versions from 6.4 to 8.2. Here is what it looks like :

Be aware that we can not be held responsible for any loss of productivity during development.

Note Support for older Symfony and PHP versions was available in previous versions of this bundle. See the CHANGELOG for more details.

Installation

• Use Composer with Symfony Flex to install GifExceptionBundle in your project:

composer require jolicode/gif-exception-bundle --dev

Now enjoy your exceptions \o/

Add some more gifs!

We need you to improve the included GIFs! Do not hesitate to open PRs to add more gifs in public/images/, it will be very welcomed! 😉

Optimizing gifs

Every gif in the repository must be optimized and resized to 145px wide, the test suite enforces it. Before committing a new gif, run the Castor task (you will need to install gifsicle):

castor optimize

Development

This project uses Castor as a task runner for common development tasks.

To install Castor, see the installation documentation.

Available tasks:

castor list           # List all available tasks
castor test           # Run the test suite
castor cs             # Fix PHP coding standards
castor cs --dry-run   # Check PHP coding standards
castor phpstan        # Run static analysis
castor optimize       # Optimize and resize gifs
castor serve          # Start the demo application

Further documentation

You can see the current and past versions using one of the following:

• the git tag command
• the releases page on Github
• the file listing the changes between versions

And some meta documentation:

• versioning and branching models
• contribution instructions

Credits

• All contributors;
• All GIFs included belong to their respective authors.

License

GifExceptionBundle is licensed under the MIT License - see the LICENSE file for details.