jolicode/gif-exception-bundle

The GhostBuster of your exception page

v1.6.4 2021-07-05 16:13 UTC

Requires

• php: ^7.1.3 || ^8.0
• symfony/framework-bundle: ^4.4 || ^5.0
• symfony/twig-bundle: ^4.4 || ^5.0

Requires (Dev)

• doctrine/annotations: ^1.2
• friendsofphp/php-cs-fixer: ^3.0
• ps/image-optimizer: ^1.0.4 || ^2.0
• symfony/asset: ^4.4 || ^5.0
• symfony/browser-kit: ^4.4 || ^5.0
• symfony/config: ^4.4 || ^5.0
• symfony/dependency-injection: ^4.4 || ^5.0
• symfony/http-kernel: ^4.4 || ^5.0
• symfony/phpunit-bridge: ^4.4 || ^5.0
• symfony/yaml: ^4.4 || ^5.0

MIT

• symfony
• exception
• random
• gif

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 4.4 to latest. Here is what it looks like :

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

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 from a Symfony project if you have this as an installed bundle via:

bin/console jolicode: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.

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.