radweb/json-exception-formatter

JSON for your Exceptions

, _(*1)

, _(*2)

Laravel JSON Exception Formatter

A small Laravel package to format & output exceptions in JSON format when required., _(*3)

By default in Laravel, throwing an Exception in debug mode will display a nice JSON response when required (eg. an AJAX response, or an Accept: application/javascript header)., _(*4)

However once you're not in debug mode (ie. a production environment), a whole HTML response is displayed instead., _(*5)

With this package, when you're not in debug mode, exceptions will be output as JSON (only without debug information like the file name & line number)., _(*6)

NOTE This does NOT affect HTML requests. Only AJAX/JSON requests are altered., _(*7)

Installation

Add radweb/json-exception-formatter to your composer.json file., _(*8)

{
    "require": {
        "radweb/json-exception-formatter": "dev-master"
    }
}

In app/config/app.php, add the Service Provider to the providers array:, _(*9)

array(
    'providers' => array(
        // ...
        'Radweb\JsonExceptionFormatter\JsonExceptionFormatterServiceProvider',
    )
)

Custom Formatters

You can override the default JSON exception formatter to use a different format, or provide more detail in the output., _(*10)

To override, implement the Radweb\JsonExceptionFormatter\FormatterInterface interface, and bind with the IoC container. This requires you to implement two methods: formatDebug() and formatPlain()., _(*11)

Example implementation:, _(*12)

<?php

use Radweb\JsonExceptionFormatter\FormatterInterface;

class CustomDebugFormatter implements FormatterInterface {

    public function formatDebug(Exception $e)
    {
        return array(
            'theError' => array(
                'message' => $e->getMessage(),
                'detail' => 'In file '.$e->getFile().' on line '.$e->getLine(),
            ),
        );
    }

    public function formatPlain(Exception $e)
    {
        return array(
            'theError' => array(
                'message' => $e->getMessage(),
                // we don't want to display debug details in production
            ),
        );
    }

}

Now we just have to bind it in the IoC container. Add this anywhere in your app's bootstrap code (if you have nowhere, routes.php will do):, _(*13)

App::bind('Radweb\JsonExceptionFormatter\FormatterInterface', 'CustomDebugFormatter');

Preview

Normal Request, Debug Mode ENABLED, _(*14)

, _(*15)

Normal Request, Debug Mode DISABLED, _(*16)

, _(*17)

JSON Request, Debug Mode ENABLED, _(*18)

, _(*19)

JSON Request, Debug Mode DISABLED, _(*20)

, _(*21)