This PR was merged into the master branch.

Commits
-------

8e8b96ec Remove all "before 1.0" exceptions and services.

Discussion
----------

Remove all "before 1.0" exceptions and services.

All theese 1.0 exceptions have been deprecated for a long time. At least since composer started to be used and since it have become so widespread i think i is time to remove thoose.

---------------------------------------------------------------------------

by fabpot at 2013-01-21T09:54:36Z

👍

---------------------------------------------------------------------------

by Baachi at 2013-01-21T10:00:08Z

👍

---------------------------------------------------------------------------

by GromNaN at 2013-01-21T14:12:22Z

👍

---------------------------------------------------------------------------

by igorw at 2013-01-21T14:58:39Z

👍 It's been 7 months and removing these will not break anything.

This PR was merged into the master branch.

Commits
-------

61bbc748 Update doc/providers/serializer.rst

Discussion
----------

Update doc/providers/serializer.rst

fixed links

---------------------------------------------------------------------------

by igorw at 2013-01-20T00:48:17Z

👍 thanks

fixed links

This PR was merged into the master branch.

Commits
-------

d740c4e2 Sample user insert snippet.

Discussion
----------

Sample user insert snippet.

The execute_query command to insert users into a sample database doesn't work with postgres due to the use of database specific string escape quotes. Changed to use the doctrine insert command which is less DB specific and better illustrates the use of DBAL.

---------------------------------------------------------------------------

by stof at 2013-01-19T11:57:24Z

👍

The execute_query command to insert users into a sample database doesn't work with postgres due to the use of database specific string escape quotes. Changed to use the doctrine insert command which is less DB specific and better illustrates the use of DBAL.

This PR was merged into the master branch.

Commits
-------

e21b3803 Support 'security' and 'stateless' flags in security config

Discussion
----------

Support 'security' and 'stateless' flags in security config

`'security' => false` will disable the firewall (for a particular area) even if there are listeners configured.

`'stateless' => true` will prevent `ContextListener` from getting registered.

---------------------------------------------------------------------------

by davedevelopment at 2013-01-05T15:01:38Z

I'm not sure I understand what you'd use these flags for, perhaps some
documentation would be useful?
 On Jan 5, 2013 10:05 AM, "Chris Heng" <notifications@github.com> wrote:

> 'security' => false will disable the firewall even if there are listeners
> configured.
>
> 'stateless' => true will prevent ContextListener from getting registered.
> ------------------------------
> You can merge this Pull Request by running:
>
>   git pull https://github.com/gigablah/Silex security-flags
>
> Or view, comment on, or merge it at:
>
>   https://github.com/fabpot/Silex/pull/573
> Commit Summary
>
>    - Support 'security' and 'stateless' flags in security config
>
> File Changes
>
>    - *M* src/Silex/Provider/SecurityServiceProvider.php (10)
>
> Patch Links
>
>    - https://github.com/fabpot/Silex/pull/573.patch
>    - https://github.com/fabpot/Silex/pull/573.diff
>
>  —
> Reply to this email directly or view it on GitHub<https://github.com/fabpot/Silex/pull/573>.
>
>

---------------------------------------------------------------------------

by gigablah at 2013-01-05T15:30:13Z

These are the same flags you can use in Symfony2. I guess `'security' => false` by itself isn't too useful, but you could hypothetically do something like:

```php
$app->register(new SecurityServiceProvider(), array(
    'security.firewalls' => array(
        'api' => array(
            'pattern' => '^/api',
            'stateless' => true,
            'security' => !$app['debug'],
            'oauth' => true
        )
    )
));
```

Which will (a) turn off oauth access token authentication when you're debugging (b) turn off read/write on the session during authentication, which isn't wanted since the oauth access token is sent for each request.

---------------------------------------------------------------------------

by davedevelopment at 2013-01-06T20:48:20Z

Sorry, I think I got confused by the security flag, I understand the stateless one.

---------------------------------------------------------------------------

by stof at 2013-01-06T21:13:04Z

The goal of the ``security`` flag is to create a firewall pattern without firewall. The only reason for this is to whitelist a pattern by placing it before another pattern without having to create a crazy regex

---------------------------------------------------------------------------

by fabpot at 2013-01-18T15:00:19Z

Can you also update the documentation about these two new settings? Thanks.

---------------------------------------------------------------------------

by gigablah at 2013-01-19T04:37:08Z

It's done. Added a section for Stateless Authentication, and a tip for the `security` flag.

This PR was merged into the master branch.

Commits
-------

ff75c9e0 Update doc/providers/security.rst

Discussion
----------

Update doc/providers/security.rst

Added closing bracket

This PR was merged into the master branch.

Commits
-------

5e0a609d Minor WS fixes in documentation

Discussion
----------

Minor WS fixes in documentation

Spaces at the end of line.

Added closing bracket

Spaces at the end of line.

This PR was merged into the master branch.

Commits
-------

eded6c78 Update doc/usage.rst

Discussion
----------

Update doc/usage.rst

I'm new to http methods other than GET and POST and spent a good few minutes searching google for "PUT DELETE"... So I thought I'd separate them somehow in the docs.

---------------------------------------------------------------------------

by davedevelopment at 2013-01-16T13:41:49Z

👍 might be better with a comma though?

---------------------------------------------------------------------------

by robincawser at 2013-01-16T13:53:08Z

Isn't the last item of a list usually separated with "or" or "and"?

---------------------------------------------------------------------------

by davedevelopment at 2013-01-16T14:01:25Z

Usually yes, not a big deal, but you never know, it might avoid people doing a google search for the "PUT or DELETE" HTTP method ;)

This PR was merged into the master branch.

Commits
-------

ae7daed9 Update doc/providers/security.rst

Discussion
----------

Take 2 on sorting out the parenthesis in the registration code snippet.

Take 2 on sorting out the parenthesis in the registration code snippet.

Take 2 on sorting out the parenthesis in the registration code snippet.

This PR was merged into the master branch.

Commits
-------

853a16a3 Fix route name in security service doc

Discussion
----------

Fix route name in security service doc

Fix a little bit confusing mistake in security doc.

I'm new to http methods other than GET and POST and spent a good few minutes searching google for PUT DELETE... So I thought I'd separate them somehow in the docs

This PR was merged into the master branch.

Commits
-------

661d632e Update doc/providers/security.rst

Discussion
----------

Update doc/providers/security.rst

Fixed spelling mistake

---------------------------------------------------------------------------

by igorw at 2013-01-15T13:26:30Z

👍

Fixed spelling mistake

This PR was merged into the master branch.

Commits
-------

d784eaeb [docs] Clarify wording of controllers-in-classes to create object

Discussion
----------

[docs] Clarify wording of controllers-in-classes to create object

This PR was merged into the master branch.

Commits
-------

2904a7a9 [docs] Inject $app to showcase that possibility
8ac1c044 [docs] Add a section about controllers in classes to usage doc

Discussion
----------

[docs] Add a section about controllers in classes to usage doc

---------------------------------------------------------------------------

by ChrisRiddell at 2013-01-10T23:40:43Z

👍 The little more information this gives is helpful :)

This PR was merged into the master branch.

Commits
-------

99fada6c Fixed comments (blocks)

Discussion
----------

Fixed comments (blocks)

Right comments in the example (block comments)

This PR was squashed before being merged into the master branch (closes #512).

Commits
-------

ce057326 ServiceControllerServiceProvider documentation

Discussion
----------

ServiceControllerServiceProvider documentation

Refs #511, I tried to change it to a PR via the API, but no dice.

---------------------------------------------------------------------------

by davedevelopment at 2012-10-15T21:28:06Z

Just a first draft, feedback appreciated, I'll be reading it through again tomorrow for a fresh take.

---------------------------------------------------------------------------

by igorw at 2012-10-15T21:53:06Z

Looks good to me. Since this is one of the common criticisms of silex from DI enthusiasts, maybe we should just support this feature out of the box.

@fabpot thoughts?

---------------------------------------------------------------------------

by davedevelopment at 2012-10-15T22:23:55Z

@stof there you go, compromising my principles for the sake of Open Source 😢

---------------------------------------------------------------------------

by igorw at 2012-10-15T22:29:58Z

i-know-that-feel.gif

---------------------------------------------------------------------------

by Mparaiso at 2012-10-17T17:59:04Z

What's the benefit of using that technique over ControllerProviders ? some declouping can be made at the controller instanciation : like
```php
$app->mount("/article",new App\Controller\ArticleController($app['article_manager'],$app['user_manager']) );
```

---------------------------------------------------------------------------

by igorw at 2012-10-17T18:08:41Z

@Mparaiso laziness: the services are only created if the controller gets called.

---------------------------------------------------------------------------

by davedevelopment at 2012-10-18T22:31:13Z

@Mparaiso having been doing this for a couple of weeks now, I think the another benefit is the way I've been writing the controllers.

I like that my routes are decoupled from the controllers and, done right, the controllers can be completely framework agnostic. Frameworks should be an implementation detail. Previously, my feelings were that the best controllers, simply delegated to a service. Now my controllers are a service, and the routing does the delegating.

---------------------------------------------------------------------------

by igorw at 2012-11-04T16:57:20Z

@fabpot I would like to hear your opinion on adding controllers as services to core.

---------------------------------------------------------------------------

by fabpot at 2012-11-05T07:36:46Z

Oops, when writing my previous comment, I mixed two PRs in my mind.

I'm in fact -1 for this.

---------------------------------------------------------------------------

by davedevelopment at 2012-11-05T09:22:55Z

I wouldn't push for this to be in core, I'd love it to be there for my own selfish reasons, but I understand it's not everyone's cup of tea.

Let's put any finishes on the cookbook and get it merged. Perhaps in time we may see more demand for it and then we can consider getting it in the core?

---------------------------------------------------------------------------

by igorw at 2012-11-05T13:10:36Z

Well, then let's not lose time arguing and just merge this into the docs.

---------------------------------------------------------------------------

by ChrisRiddell at 2012-11-06T10:07:21Z

I am all for this cookbook, I'll be using this for my next project, having a bit more structure as a full framework without a full framework is nice.

---------------------------------------------------------------------------

by fabpot at 2012-11-06T10:41:17Z

There is no link between "having a bit more structure" and "using controllers as services". You can just create classes for your controllers without adding them to the service container.

---------------------------------------------------------------------------

by ChrisRiddell at 2012-11-06T11:14:54Z

Okay had to read the requested cookbook a number of times but I sort understand now.

1) What's the major advantage in doing this?
2) so overriding the controller resolver only gives you better looking route defining?

---------------------------------------------------------------------------

by davedevelopment at 2012-11-06T11:36:17Z

@ChrisRiddell it's a lot about personal preference. I prefer this as it promotes Dependency Injection over Service Location, which, without sounding like a dick, you can read about all over the web, I'd start with http://martinfowler.com/articles/injection.html#ServiceLocatorVsDependencyInjection, then try the google.

---------------------------------------------------------------------------

by simensen at 2012-11-09T03:15:35Z

👍

I was just asking about this tonight. I think this would be very useful to have *at least* as a cookbook entry. What reasons would there be to not add this to core? I'm curious to what sort of downsides there might be to allowing it.

As a point of reference, I'd like to present one of my earliest attempts to try and figure out how I wanted to use Silex and how supporting this out of the box could have changed my code.

Originally (currently) I had to duplicate the method signature for each of my controller actions:

```php
<?php
use Symfony\Component\HttpFoundation\Request;

/**
 * API App
 *
 * @author Beau Simensen <beau@dflydev.com>
 */
class Api extends AbstractApp
{
    const ROUTE_ROOT = 'my_api_root';
    const ROUTE_AUTH_ROOT = 'my_api_auth_root';
    const ROUTE_AUTH_AUTHENTICATE = 'my_api_auth_authenticate';
    const ROUTE_ROUTE_ROOT = 'my_api_route_root';
    const ROUTE_ROUTE_CREATE = 'my_api_route_create';
    const ROUTE_ROUTE_FIND = 'my_api_route_find';
    const ROUTE_ROUTE_DETAIL = 'my_api_route_detail';
    const ROUTE_SERVICE_ROOT = 'my_api_service_root';
    const ROUTE_SERVICE_CREATE = 'my_api_service_create';
    const ROUTE_SERVICE_FIND = 'my_api_service_find';
    const ROUTE_SERVICE_DETAIL = 'my_api_service_detail';

    protected function configure()
    {
        parent::configure();

        $app = $this;

        $app['my.api.controller.rootController'] = $app->share(function() use ($app) {
            return new Api\Controller\RootController($app);
        });

        $app['my.api.controller.authController'] = $app->share(function() use ($app) {
            return new Api\Controller\AuthController($app);
        });

        $app['my.api.controller.routeController'] = $app->share(function() use ($app) {
            return new Api\Controller\RouteController($app);
        });

        $app['my.api.controller.serviceController'] = $app->share(function() use ($app) {
            return new Api\Controller\ServiceController($app);
        });

        $app->get('/', function() use ($app) {
            return $app['my.api.controller.rootController']->rootAction();
        })->bind(self::ROUTE_ROOT);

        $app->get('/auth', function() use ($app) {
            return $app['my.api.controller.authController']->rootAction();
        })->bind(self::ROUTE_AUTH_ROOT);

        $app->post('/auth/authenticate', function(Request $request) use ($app) {
            return $app['my.api.controller.authController']->authenticateAction($request);
        })->bind(self::ROUTE_AUTH_AUTHENTICATE);

        $app->get('/route', function() use ($app) {
            return $app['my.api.controller.routeController']->rootAction();
        })->bind(self::ROUTE_ROUTE_ROOT);

        $app->post('/route/routes', function(Request $request) use ($app) {
            return $app['my.api.controller.routeController']->createAction($request);
        })->bind(self::ROUTE_ROUTE_CREATE);

        $app->post('/route/find', function(Request $request) use ($app) {
            return $app['my.api.controller.routeController']->findAction($request);
        })->bind(self::ROUTE_ROUTE_FIND);

        $app->get('/route/routes/{routeId}', function(Request $request, $routeId) use ($app) {
            return $app['my.api.controller.routeController']->detailAction($request, $routeId);
        })->bind(self::ROUTE_ROUTE_DETAIL);

        $app->get('/service', function(Request $request) use ($app) {
            return $app['my.api.controller.serviceController']->rootAction($request);
        })->bind(self::ROUTE_SERVICE_ROOT);

        $app->post('/service/services', function(Request $request, $serviceKey) use ($app) {
            return $app['my.api.controller.serviceController']->createAction($request, $serviceKey);
        })->bind(self::ROUTE_SERVICE_CREATE);

        $app->post('/service/find', function(Request $request) use ($app) {
            return $app['my.api.controller.serviceController']->findAction($request);
        })->bind(self::ROUTE_SERVICE_FIND);

        $app->get('/service/services/{serviceKey}', function(Request $request, $serviceKey) use ($app) {
            return $app['my.api.controller.serviceController']->detailAction($request, $serviceKey);
        })->bind(self::ROUTE_SERVICE_DETAIL);
    }
}
```

Using controllers as a service correctly, I can cut the amount of times I define my method signature in half and it looks more readable:

```php
<?php
use Symfony\Component\HttpFoundation\Request;

/**
 * API App
 *
 * @author Beau Simensen <beau@dflydev.com>
 */
class Api extends AbstractApp
{
    const ROUTE_ROOT = 'my_api_root';
    const ROUTE_AUTH_ROOT = 'my_api_auth_root';
    const ROUTE_AUTH_AUTHENTICATE = 'my_api_auth_authenticate';
    const ROUTE_ROUTE_ROOT = 'my_api_route_root';
    const ROUTE_ROUTE_CREATE = 'my_api_route_create';
    const ROUTE_ROUTE_FIND = 'my_api_route_find';
    const ROUTE_ROUTE_DETAIL = 'my_api_route_detail';
    const ROUTE_SERVICE_ROOT = 'my_api_service_root';
    const ROUTE_SERVICE_CREATE = 'my_api_service_create';
    const ROUTE_SERVICE_FIND = 'my_api_service_find';
    const ROUTE_SERVICE_DETAIL = 'my_api_service_detail';

    protected function configure()
    {
        parent::configure();

        $app = $this;

        $app['my.api.controller.rootController'] = $app->share(function() use ($app) {
            return new Api\Controller\RootController($app);
        });

        $app['my.api.controller.authController'] = $app->share(function() use ($app) {
            return new Api\Controller\AuthController($app);
        });

        $app['my.api.controller.routeController'] = $app->share(function() use ($app) {
            return new Api\Controller\RouteController($app);
        });

        $app['my.api.controller.serviceController'] = $app->share(function() use ($app) {
            return new Api\Controller\ServiceController($app);
        });

        $app->get('/', 'my.api.controller.rootController:rootAction')->bind(self::ROUTE_ROOT);

        $app->get('/auth', 'my.api.controller.authController:rootAction')
            ->bind(self::ROUTE_AUTH_ROOT);

        $app->post('/auth/authenticate', 'my.api.controller.authController:authenticateAction')
            ->bind(self::ROUTE_AUTH_AUTHENTICATE);

        $app->get('/route', 'my.api.controller.routeController:rootAction')
            ->bind(self::ROUTE_ROUTE_ROOT);

        $app->post('/route/routes', 'my.api.controller.routeController:createAction')
            ->bind(self::ROUTE_ROUTE_CREATE);

        $app->post('/route/find', 'my.api.controller.routeController:findAction')
            ->bind(self::ROUTE_ROUTE_FIND);

        $app->get('/route/routes/{routeId}', 'my.api.controller.routeController:detailAction')
            ->bind(self::ROUTE_ROUTE_DETAIL);

        $app->get('/service', 'my.api.controller.serviceController:rootAction')
            ->bind(self::ROUTE_SERVICE_ROOT);

        $app->post('/service/services', 'my.api.controller.serviceController:createAction')
            ->bind(self::ROUTE_SERVICE_CREATE);

        $app->post('/service/find', 'my.api.controller.serviceController:findAction')
            ->bind(self::ROUTE_SERVICE_FIND);

        $app->get('/service/services/{serviceKey}', 'my.api.controller.serviceController:detailAction')
            ->bind(self::ROUTE_SERVICE_DETAIL);
    }
}
```

In any event, this is a great extension. :) Whether it ends up in core or not I'll need to add this to my toolbox.

---------------------------------------------------------------------------

by spantaleev at 2012-11-09T08:58:46Z

To move my "controllers" to methods on an object, I've been instantiating the controller object and registering the routes like this:

    $controller = new NewsController($app);

    $collection->get('/index', array($controller, 'indexAction'))->bind('news.index');
    $collection->get('/view/{id}', array($controller, 'viewAction'))->bind('news.view');

This way, at least I don't have to define the method signatures twice and pass around the arguments manually, as @simensen originally did.

It does have some overhead, because the controller object needs to be created. It also looks a bit ugly passing the callbacks like that.

Seems like the "controller.service:action" method is cleaner and flexible enough to allow injecting the whole container or the individual controller dependencies. With my way of doing things (above), I can't afford to inject individual dependencies into the controller class even if I wanted to (because all controller objects in the app are always created, which will lead to a lot of unnecessary services being created as well).

It would be nice to have something standard like this in core, instead of having everyone override the controller resolver or use their own ugly way around the problem. I can see how going the "class controllers" route can complicate things though - it could lead to talks about adding a ContainerAware base controller class, etc.

---------------------------------------------------------------------------

by ChrisRiddell at 2012-11-09T10:12:46Z

@simensen I am very interested in how you setup your project like that, If your configure is protected i am assuming you extend each AbstractApp with Silex and run the configure method.

I am asking this as the way you have setup Silex by the look of things is very clean, I start playing around with using Controllers and it got messy fast.

On Topic:

I think something like this as core, would be as it gives you the option of using controller classes or route callbacks, But keep it simple by not going down the path of ContainerAware etc.

---------------------------------------------------------------------------

by stof at 2012-11-09T23:37:47Z

@ChrisRiddell I encourage you to read https://igor.io/2012/11/09/scaling-silex.html

---------------------------------------------------------------------------

by simensen at 2012-12-13T12:44:38Z

@fabpot What reasons do you have for being 👎 on this? I'm curious as to what sort of downsides you see.

I'm 👍 on having this just be a part of Silex and not requiring people to use an optional decorator or copy and paste cookbook code.

---------------------------------------------------------------------------

by davedevelopment at 2013-01-04T01:50:52Z

@fabpot that last commit moved to a composition based solution, do you think we could get this in now?

---------------------------------------------------------------------------

by igorw at 2013-01-04T01:59:56Z

A very strong 👍 from me.

---------------------------------------------------------------------------

by ChrisRiddell at 2013-01-04T02:10:04Z

👍

---------------------------------------------------------------------------

by simensen at 2013-01-04T02:28:57Z

👍

I'm still curious to know what kind of downsides there are to having Silex do this natively but if it has to be a cookbook entry to get the word out I'm all for it going in as-is. :)

---------------------------------------------------------------------------

by igorw at 2013-01-06T14:27:39Z

@fabpot can you please re-review this? IMO it would be a valuable addition to the docs.

---------------------------------------------------------------------------

by fabpot at 2013-01-07T11:00:15Z

I'm back! I really like the new implementation that uses composition. Thanks @davedevelopment. After thinking about this topic a lot during my holidays, here are my new thoughts (new year, new thoughts ;)):

* As the new implementation is quite straightforward, I'm +1 for moving the code to Silex core (the cookbook can just mention how to enable it then).

* The cookbook should IMO emphasise one of the big benefit (already mentioned above): creating controllers that are framework agnostic. At first, it does not seem like a big deal, but when you want to publish some code that needs to be reused, it becomes crucial. I worked on a project a few days ago and I was able to create controllers that are compatible with Symfony (full-stack), Silex, and Drupal; that's a big deal!

---------------------------------------------------------------------------

by davedevelopment at 2013-01-07T11:26:44Z

Awesome, this has made my morning.

I'll write another PR, with the decorator and some tests, then modify this PR to emphasise the major benefits (especially the framework agnostic part) and explain how to enable the decorator.

---------------------------------------------------------------------------

by jmontoyaa at 2013-01-07T11:28:50Z

Great news!

---------------------------------------------------------------------------

by igorw at 2013-01-07T15:24:37Z

@fabpot awesome, glad to hear!

---------------------------------------------------------------------------

by simensen at 2013-01-07T17:17:49Z

@fabpot Hurray! :)

This PR was squashed before being merged into the master branch (closes #575).

Commits
-------

9ce84e86 Service based controller resolver

Discussion
----------

Service based controller resolver

As discussed in #512

I've extended `RouterTest` to ensure existing behaviour is not affected when using the `ServiceControllerResolver`, I can remove it if it is considered overkill.

---------------------------------------------------------------------------

by GromNaN at 2013-01-07T15:14:00Z

You could add a service provider, so that we only have to register it to get the feature.

---------------------------------------------------------------------------

by igorw at 2013-01-07T15:33:57Z

+1 for service provider.

---------------------------------------------------------------------------

by davedevelopment at 2013-01-07T16:35:03Z

Currently thinking of a reasonable name for a service provider, answers on a post card.

---------------------------------------------------------------------------

by simensen at 2013-01-09T19:37:17Z

Excited to see this get in. Thanks for your work on it @davedevelopment !

---------------------------------------------------------------------------

by igorw at 2013-01-09T23:20:47Z

👍

This PR was merged into the master branch.

Commits
-------

e58fa916 Test against PHP 5.5 on travis
d3f96597 Make travis install from source, fixes 403 responses

Discussion
----------

Travis: Fix 403 errors, test against PHP 5.5

This PR was merged into the master branch.

Commits
-------

44ba6e72 Call parent constructor in app, to initialize pimple

Discussion
----------

Call parent constructor in app, to initialize pimple

This PR was merged into the master branch.

Commits
-------

6543379c Allow constructor arguments.

Discussion
----------

Allow constructor arguments.

Unfortunately my phpunit installation is horribly broken so I can't run the tests right now...

---------------------------------------------------------------------------

by igorw at 2012-11-27T00:21:38Z

👍

---------------------------------------------------------------------------

by igorw at 2012-11-27T00:21:49Z

Docs?

---------------------------------------------------------------------------

by igorw at 2012-11-27T00:24:24Z

The parent constructor should probably be called at the end, that allows parameters to override the default services. And you should add a test case for that too.

---------------------------------------------------------------------------

by GromNaN at 2012-11-27T07:54:31Z

@igorw The parent constructor replaces everything, so it cannot be called at the end.
https://github.com/fabpot/Pimple/blob/master/lib/Pimple.php#L46

---------------------------------------------------------------------------

by fabpot at 2013-01-03T08:10:28Z

What about just calling `array_replace($this->values, $values)` at the end of the constructor instead?

---------------------------------------------------------------------------

by igorw at 2013-01-03T08:35:02Z

Sounds good to me.

This PR was merged into the master branch.

Commits
-------

d272d710 [docs] Add cookbook recipe for the ErrorHandler

Discussion
----------

[docs] Add cookbook recipe for the ErrorHandler

---------------------------------------------------------------------------

by igorw at 2013-01-03T00:46:52Z

bump.

---------------------------------------------------------------------------

by davedevelopment at 2013-01-03T01:02:13Z

👍  looks good