zeuxisoo/slim-whoops

PHP whoops error on slim framework

0.6.4 2018-06-25 03:53 UTC

README

PHP whoops error on slim framework

Status

Build Status Downloads this Month Latest Stable Version

Installation

Install the composer

curl -sS https://getcomposer.org/installer | php

Edit composer.json

Slim Whoops Version Global Mode PHP DI
1 n/a 0.1.* no no
2 1.* 0.3.* no no
3 <= 1.* 0.4.* no no
3 >= 2.* 0.5.* no no
3 >= 2.* 0.6.* yes yes

For Slim framework 3, The composer.json will looks like

{
	"require": {
		"zeuxisoo/slim-whoops": "0.6.*"
	}
}

Now, install or update the dependencies

php composer.phar install

Usage

Just need to add the middleware in your slim application.

Simple way

In this case, You must ensure this line is first added and on top of other middlewares

$app->add(new \Zeuxisoo\Whoops\Provider\Slim\WhoopsMiddleware);
$app->add(new \Other\MiddlewareA);
$app->add(new \Other\MiddlewareB);

Better DI

In this case, You can place this line anywhere no position required

$app->add(new \Zeuxisoo\Whoops\Provider\Slim\WhoopsMiddleware($app));

Global mode

In this case, The following code can make Whoops errors in the global scope, whether you have destroyed the program's life cycle

$whoopsGuard = new \Zeuxisoo\Whoops\Provider\Slim\WhoopsGuard();
$whoopsGuard->setApp($app);
$whoopsGuard->setRequest($container['request']);
$whoopsGuard->setHandlers([]);
$whoopsGuard->install();

Custom Whoops Handler

In this case, You can push custom handler to whoops. For example:

A handler like:

$simplyErrorHandler = function($exception, $inspector, $run) {
    $message = $exception->getMessage();
    $title   = $inspector->getExceptionName();

    echo "{$title} -> {$message}";
    exit;
};

Middleware case like:

new \Zeuxisoo\Whoops\Provider\Slim\WhoopsMiddleware($app, [$simplyErrorHandler]);

Global mode case like:

$whoopsGuard = new \Zeuxisoo\Whoops\Provider\Slim\WhoopsGuard();
$whoopsGuard->setHandlers([$simplyErrorHandler]);

Options

E.g. Opening referenced files with your favorite editor or IDE and so on

$app = new App([
    'settings' => [
    	 // Enable whoops
        'debug' => true,

        // Support click to open editor
        'whoops.editor' => 'sublime',

        // Set page title
        'whoops.page_title' => 'Custom page title',

        // Display call stack in orignal slim error when debug is off
        'displayErrorDetails' => true,
    ]
]);

Important Note

Version 0.3.0

Version 0.2.0

  • You must to install the whoops library manually.

Testing

Run the test cases

php vendor/bin/phpunit