HandleUncaughtException - Code Metrics - jasny/error-handler - Measure and Improve Code Quality continuously with Scrutinizer

HandleUncaughtException A
last analyzed 2017-01-25 01:31 UTC

↳ Parent: Project

Complexity

Total Complexity

Size/Duplication

Total Lines	128
Duplicated Lines	0 %

Coupling/Cohesion

Components	1
Dependencies	0

Test Coverage

Coverage

100%

Importance

Changes

Metric	Value
wmc	13
c	0
b	0
f	0
lcom	1
cbo	0
dl	0
loc	128
ccs	29
cts	29
cp	1
rs	10

9 Methods

Rating	Name	Size	Complexity
	setErrorHandler()	1	?
	setExceptionHandler()	1	?
	log()	1	?
	getLoggedErrorTypes()	1	?
A	getChainedExceptionHandler()	4	1
A	getLoggedExceptionClasses()	4	1
A	logUncaughtException()	8	2
A	initExceptionHandler()	6	3
B	handleException()	28	6

<?php

namespace Jasny\ErrorHandler;

/**
 * Trait for handling uncaught exceptions using PHP's exception handler
 */
trait HandleUncaughtException
{
    /**
     * @var callable|false
     */
    protected $chainedExceptionHandler;


    /**
     * Log the following exception classes (and subclasses)
     * @var array
     */
    protected $logExceptionClasses = [];


    /**
     * Wrapper method for `set_error_handler`
     * 
     * @param callable $callback
     * @param int      $error_types
     * @return callable|null
     */
    abstract protected function setErrorHandler($callback, $error_types = E_ALL);

    /**
     * Wrapper method for `set_exception_handler`
     * 
     * @param callable $callback
     * @return callable|null
     */
    abstract protected function setExceptionHandler($callback);

    /**
     * Log an error or exception
     * 
     * @param \Exception|\Error $error
     * @return void
     */
    abstract public function log($error);

    /**
     * Get the types of errors that will be logged
     * 
     * @return int  Binary set of E_* constants
     */
    abstract public function getLoggedErrorTypes();


    /**
     * Get the error handler that has been replaced.
     * 
     * @return callable|false|null
     */
    public function getChainedExceptionHandler()
    {
        return $this->chainedExceptionHandler;
    }
    
    /**
     * Get a list of Exception and other Throwable classes that will be logged
     * @return array
     */
    public function getLoggedExceptionClasses()
    {
        return $this->logExceptionClasses;
    }
    
    
    /**
     * Log these types of errors or exceptions
     * 
     * @param string $class  Exception class name
     */
    protected function logUncaughtException($class)
    {
        if (!in_array($class, $this->logExceptionClasses)) {
            $this->logExceptionClasses[] = $class;
        }

        $this->initExceptionHandler();
    }

    
    /**
     * Use the global error handler
     */
    protected function initExceptionHandler()
    {
        if (!isset($this->chainedExceptionHandler)) {
            $this->chainedExceptionHandler = $this->setExceptionHandler([$this, 'handleException']) ?: false;
        }
    }
    
    /**
     * Uncaught exception handler
     * @ignore
     * 
     * @param \Exception|\Error $exception
     */
    public function handleException($exception)
    {
        $this->setExceptionHandler(null);
function acceptsInteger($int) { }

$x = '123'; // string "123"

// Instead of
acceptsInteger($x);

// we recommend to use
acceptsInteger((integer) $x);
        $this->setErrorHandler(null);
function acceptsInteger($int) { }

$x = '123'; // string "123"

// Instead of
acceptsInteger($x);

// we recommend to use
acceptsInteger((integer) $x);
        
        $isInstanceOf = array_map(function ($class) use ($exception) {
            return is_a($exception, $class);
        }, $this->logExceptionClasses);
        
        if ($exception instanceof \Error || $exception instanceof \ErrorException) {
            $type = $exception instanceof \Error ? $exception->getCode() : $exception->getSeverity();
            $shouldLog = $this->getLoggedErrorTypes() & $type;
        } else {
            $shouldLog = array_sum($isInstanceOf) > 0;
        }
        
        if ($shouldLog) {
            $this->log($exception);
        }
        
        $this->callOnFatalError($exception);
trait Idable {
    public function equalIds(Idable $other) {
        return $this->getId() === $other->getId();
    }
}
        
        if ($this->chainedExceptionHandler) {
            call_user_func($this->chainedExceptionHandler, $exception);
        }
        
        throw $exception; // This is now handled by the default exception and error handler
    }
}



1		<?php
2
3		namespace Jasny\ErrorHandler;
4
5		/**
6		* Trait for handling uncaught exceptions using PHP's exception handler
7		*/
8		trait HandleUncaughtException
9		{
10		/**
11		* @var callable\|false
12		*/
13		protected $chainedExceptionHandler;
14
15
16		/**
17		* Log the following exception classes (and subclasses)
18		* @var array
19		*/
20		protected $logExceptionClasses = [];
21
22
23		/**
24		* Wrapper method for `set_error_handler`
25		*
26		* @param callable $callback
27		* @param int $error_types
28		* @return callable\|null
29		*/
30		abstract protected function setErrorHandler($callback, $error_types = E_ALL);
31
32		/**
33		* Wrapper method for `set_exception_handler`
34		*
35		* @param callable $callback
36		* @return callable\|null
37		*/
38		abstract protected function setExceptionHandler($callback);
39
40		/**
41		* Log an error or exception
42		*
43		* @param \Exception\|\Error $error
44		* @return void
45		*/
46		abstract public function log($error);
47
48		/**
49		* Get the types of errors that will be logged
50		*
51		* @return int Binary set of E_* constants
52		*/
53		abstract public function getLoggedErrorTypes();
54
55
56		/**
57		* Get the error handler that has been replaced.
58		*
59		* @return callable\|false\|null
60		*/
61	2	public function getChainedExceptionHandler()
62		{
63	2	return $this->chainedExceptionHandler;
64		}
65
66		/**
67		* Get a list of Exception and other Throwable classes that will be logged
68		* @return array
69		*/
70	4	public function getLoggedExceptionClasses()
71		{
72	4	return $this->logExceptionClasses;
73		}
74
75
76		/**
77		* Log these types of errors or exceptions
78		*
79		* @param string $class Exception class name
80		*/
81	18	protected function logUncaughtException($class)
82		{
83	18	if (!in_array($class, $this->logExceptionClasses)) {
84	18	$this->logExceptionClasses[] = $class;
85		}
86
87	18	$this->initExceptionHandler();
88	18	}
89
90
91		/**
92		* Use the global error handler
93		*/
94	18	protected function initExceptionHandler()
95		{
96	18	if (!isset($this->chainedExceptionHandler)) {
97	18	$this->chainedExceptionHandler = $this->setExceptionHandler([$this, 'handleException']) ?: false;
98		}
99	18	}
100
101		/**
102		* Uncaught exception handler
103		* @ignore
104		*
105		* @param \Exception\|\Error $exception
106		*/
107	18	public function handleException($exception)
108		{
109	18	$this->setExceptionHandler(null);
		0 ignored issues – show Documentation introduced 2017-01-03 21:31 UTC by Report Bug Copy Issue Report `null` is of type `null`, but the function expects a `callable`. It seems like the type of the argument is not accepted by the function/method which you are calling. In some cases, in particular if PHP’s automatic type-juggling kicks in this might be fine. In other cases, however this might be a bug. We suggest to add an explicit type cast like in the following example: function acceptsInteger($int) { } $x = '123'; // string "123" // Instead of acceptsInteger($x); // we recommend to use acceptsInteger((integer) $x); Loading history...
110	18	$this->setErrorHandler(null);
		0 ignored issues – show Documentation introduced 2017-01-03 21:31 UTC by Report Bug Copy Issue Report `null` is of type `null`, but the function expects a `callable`. It seems like the type of the argument is not accepted by the function/method which you are calling. In some cases, in particular if PHP’s automatic type-juggling kicks in this might be fine. In other cases, however this might be a bug. We suggest to add an explicit type cast like in the following example: function acceptsInteger($int) { } $x = '123'; // string "123" // Instead of acceptsInteger($x); // we recommend to use acceptsInteger((integer) $x); Loading history...
111
112	18	$isInstanceOf = array_map(function ($class) use ($exception) {
113	12	return is_a($exception, $class);
114	18	}, $this->logExceptionClasses);
115
116	18	if ($exception instanceof \Error \|\| $exception instanceof \ErrorException) {
117	4	$type = $exception instanceof \Error ? $exception->getCode() : $exception->getSeverity();
118	4	$shouldLog = $this->getLoggedErrorTypes() & $type;
119		} else {
120	14	$shouldLog = array_sum($isInstanceOf) > 0;
121		}
122
123	18	if ($shouldLog) {
124	12	$this->log($exception);
125		}
126
127	18	$this->callOnFatalError($exception);
		0 ignored issues – show Bug introduced 2017-01-03 21:31 UTC by Report Bug Copy Issue Report It seems like `callOnFatalError()` must be provided by classes using this trait. How about adding it as abstract method to this trait? This check looks for methods that are used by a trait but not required by it. To illustrate, let’s look at the following code example trait Idable { public function equalIds(Idable $other) { return $this->getId() === $other->getId(); } } The trait `Idable` provides a method `equalsId` that in turn relies on the method `getId()`. If this method does not exist on a class mixing in this trait, the method will fail. Adding the `getId()` as an abstract method to the trait will make sure it is available. Loading history...
128
129	18	if ($this->chainedExceptionHandler) {
130	6	call_user_func($this->chainedExceptionHandler, $exception);
131		}
132
133	18	throw $exception; // This is now handled by the default exception and error handler
134		}
135		}
136
137

jasny / error-handler

HandleUncaughtException A last analyzed 2017-01-25 01:31 UTC

Complexity

Size/Duplication

Coupling/Cohesion

Test Coverage

Importance

9 Methods

Duplication Side-by-Side

Filter issues like

HandleUncaughtException A
last analyzed 2017-01-25 01:31 UTC