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 5.4 to 8.0. 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 Resources/public/images/, it will be very welcomed! 😉

Optimizing gifs

If you are adding gifs we strongly recommend optimizing them. There is a tool to aid with this (you will need to install gifsicle).

bin/optimizer.php

You can also run this command directly from your Symfony application:

bin/console gifexception:optimize

Although it would probably make more sense to use the former and push up the optimized gifs.

It uses gifsicle to optimize gifs via the image-optimizer library.

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

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.