mabs/exceptionizer-bundle

This bundle provides a simple way to play with php Exceptions.

exceptionizer-bundle

, _(*1)

Play with Exceptions :D This bundle help to get a low coupling between exception class object in your code, _(*2)

Installation

Exceptionizer uses Composer, please checkout the composer website for more information., _(*3)

The simple following command will install exceptionizer-bundle into your project. It also add a new entry in your composer.json and update the composer.lock as well., _(*4)

$ composer require 'mabs/exceptionizer-bundle'

Then, you can enable it in your kernel:, _(*5)

// app/AppKernel.php
public function registerBundles()
{
    $bundles = array(
        ...
        new Mabs\ExceptionizerBundle\MabsExceptionizerBundle(),
        ...

Usage

Now you can use Exceptionizer service to throw Exceptions:, _(*6)

$this->container->get('exceptionizer')
->throwException('\\Symfony\\Component\\HttpKernel\\Exception\\NotFoundHttpException', array('Your message'));

OR define your Exception in your config.yml file like this :, _(*7)

mabs_exceptionizer:
    exceptions:
        bar_code_exception:
            class: Mabs\BarCodeBundle\Exception\BarCodeException
            arguments:                          # optional
                message: "bar code exception"   # optional
                code:  0                        # optional

and pass the config key to the service:, _(*8)

$this->container->get('exceptionizer')->throwException('bar_code_exception');

Events and listener:

ExceptionizerBundle provide two events:, _(*9)

namespace Mabs\ExceptionizerBundle;


final class ExceptionizerEvents
{

    const EXCEPTIONIZER_PRE_THROW = 'exceptionizer.pre_throw';

    const EXCEPTIONIZER_POST_CATCH = 'exceptionizer.post_catch';
}

exceptionizer.pre_throw : before throw Exception, _(*10)

exceptionizer.post_catch: (will be documented later when we speak about the Exception Catcher), _(*11)

Now you can create Listeners to do a specific job when an exception will be thrown ;) and to learn more about the EventDispatcher Component in symfony2 pleaze read the documentation, _(*12)

License

This bundle is available under the MIT license., _(*13)