jolicode / gif-exception-bundle
The GhostBuster of your exception page
Installs: 92 807
Dependents: 0
Suggesters: 0
Security: 0
Stars: 207
Watchers: 24
Forks: 15
Open Issues: 0
Type:symfony-bundle
Requires
- php: >=8.1
- symfony/framework-bundle: ^5.4 || ^6.0 || ^7.0
- symfony/twig-bundle: ^5.4 || ^6.0 || ^7.0
Requires (Dev)
- doctrine/annotations: ^2.0
- friendsofphp/php-cs-fixer: ^3.17
- phpstan/phpstan: ^1.10
- ps/image-optimizer: ^1.0.4 || ^2.0
- symfony/asset: ^5.4 || ^6.0 || ^7.0
- symfony/browser-kit: ^5.4 || ^6.0 || ^7.0
- symfony/config: ^5.4 || ^6.0 || ^7.0
- symfony/console: ^5.4 || ^6.0 || ^7.0
- symfony/dependency-injection: ^5.4 || ^6.0 || ^7.0
- symfony/error-handler: ^5.4 || ^6.0 || ^7.0
- symfony/http-kernel: ^5.4 || ^6.0 || ^7.0
- symfony/monolog-bundle: ^3.8 || ^7.0
- symfony/phpunit-bridge: ^6.3 || ^7.0
- symfony/stopwatch: ^5.4 || ^6.0 || ^7.0
- symfony/web-profiler-bundle: ^5.4 || ^6.0 || ^7.0
- symfony/yaml: ^5.4 || ^6.0 || ^7.0
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 latest. 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 previous Symfony 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.
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:
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.