krypter/catchor

This package gives you an easy way to manage exceptions.

Laravel Catchor

This package gives you an easy way to manage exceptions., _(*1)

Installation

Install Catchor through Composer., _(*2)

"require": {
    "krypter/catchor": "0.2"
}

Publish the config file from the command line. (optional) The config file will be publish here app/config/packages/krypter/catchor/config.php., _(*3)

php artisan config:publish krypter/catchor

Update app/config/app.php to include a reference to this package's service provider in the providers array., _(*4)

'providers' => [
    'Krypter\Catchor\CatchorServiceProvider'
]

Usage

With a simple file

By default Catchor looking for app/exceptions/catchers.php. You need to create the exceptions directory inside the app directory and create a file named catchers.php inside the exceptions directory., _(*5)

Finaly, write the code you want in it., _(*6)

<?php 

// Example
App::error(function(Exception $e)
{
    Log::error($e);
});

You can change the path of this file and/or add other files if you want it to. You must publish the config and modify the raw_files array., _(*7)

'raw_files' => [
    app_path() . '/exceptions/catchers.php',  // By default
    '/path/to/your/file.php' // Your path
]

You're done!, _(*8)

With a class

First, create a class. It must extends Krypter\Catchor\ExceptionCatcher, _(*9)

<?php namespace Acme\Exception;

use Krypter\Catchor\ExceptionCatcher;

class Catcher extends ExceptionCatcher {

    // We will catch exception from here

}

Next, add functions starting with catch, _(*10)

// Template
public function catchException(\Exception $e, $code, $fromConsole)
{
    return 'Do what you wanna do!';
}

// Real world example
public function catchNotFoundHttpException(\Symfony\Component\HttpKernel\Exception\NotFoundHttpException $e, $code, $fromConsole)
{
    return \View::make('pages.404');
}

You can also use raw() method and write what you want in it. To enable this option you need to add public $raw = true;, _(*11)

public $raw = true;

public function raw()
{
    // Example
    App::error(function(Exception $e)
    {
        Log::error($e);
    });
}

If you don't have method starting with catch you need to disable this option by adding public $catch = false., _(*12)

Finally, you must have publish the config, empty the raw_files array (unless you use it) and modify the catchers array to add this class in the config file. (You can add multiple catcher), _(*13)

'catchers' => [
    'Acme\Exception\Catcher'
],
'raw_files' => []

You're done!, _(*14)

MIT License

View the license for this repo., _(*15)

Contact

Follow @krypter_io on Twitter for the latest news., _(*16)