annotate vendor/zendframework/zend-stdlib/src/ErrorHandler.php @ 19:fa3358dc1485 tip

Add ndrum files
author Chris Cannam
date Wed, 28 Aug 2019 13:14:47 +0100
parents 5fb285c0d0e3
children
rev   line source
Chris@0 1 <?php
Chris@0 2 /**
Chris@0 3 * Zend Framework (http://framework.zend.com/)
Chris@0 4 *
Chris@0 5 * @link http://github.com/zendframework/zf2 for the canonical source repository
Chris@0 6 * @copyright Copyright (c) 2005-2015 Zend Technologies USA Inc. (http://www.zend.com)
Chris@0 7 * @license http://framework.zend.com/license/new-bsd New BSD License
Chris@0 8 */
Chris@0 9
Chris@0 10 namespace Zend\Stdlib;
Chris@0 11
Chris@0 12 use ErrorException;
Chris@0 13
Chris@0 14 /**
Chris@0 15 * ErrorHandler that can be used to catch internal PHP errors
Chris@0 16 * and convert to an ErrorException instance.
Chris@0 17 */
Chris@0 18 abstract class ErrorHandler
Chris@0 19 {
Chris@0 20 /**
Chris@0 21 * Active stack
Chris@0 22 *
Chris@0 23 * @var array
Chris@0 24 */
Chris@0 25 protected static $stack = [];
Chris@0 26
Chris@0 27 /**
Chris@0 28 * Check if this error handler is active
Chris@0 29 *
Chris@0 30 * @return bool
Chris@0 31 */
Chris@0 32 public static function started()
Chris@0 33 {
Chris@0 34 return (bool) static::getNestedLevel();
Chris@0 35 }
Chris@0 36
Chris@0 37 /**
Chris@0 38 * Get the current nested level
Chris@0 39 *
Chris@0 40 * @return int
Chris@0 41 */
Chris@0 42 public static function getNestedLevel()
Chris@0 43 {
Chris@0 44 return count(static::$stack);
Chris@0 45 }
Chris@0 46
Chris@0 47 /**
Chris@0 48 * Starting the error handler
Chris@0 49 *
Chris@0 50 * @param int $errorLevel
Chris@0 51 */
Chris@0 52 public static function start($errorLevel = \E_WARNING)
Chris@0 53 {
Chris@12 54 if (! static::$stack) {
Chris@0 55 set_error_handler([get_called_class(), 'addError'], $errorLevel);
Chris@0 56 }
Chris@0 57
Chris@0 58 static::$stack[] = null;
Chris@0 59 }
Chris@0 60
Chris@0 61 /**
Chris@0 62 * Stopping the error handler
Chris@0 63 *
Chris@0 64 * @param bool $throw Throw the ErrorException if any
Chris@0 65 * @return null|ErrorException
Chris@13 66 * @throws ErrorException If an error has been caught and $throw is true
Chris@0 67 */
Chris@0 68 public static function stop($throw = false)
Chris@0 69 {
Chris@0 70 $errorException = null;
Chris@0 71
Chris@0 72 if (static::$stack) {
Chris@0 73 $errorException = array_pop(static::$stack);
Chris@0 74
Chris@12 75 if (! static::$stack) {
Chris@0 76 restore_error_handler();
Chris@0 77 }
Chris@0 78
Chris@0 79 if ($errorException && $throw) {
Chris@0 80 throw $errorException;
Chris@0 81 }
Chris@0 82 }
Chris@0 83
Chris@0 84 return $errorException;
Chris@0 85 }
Chris@0 86
Chris@0 87 /**
Chris@0 88 * Stop all active handler
Chris@0 89 *
Chris@0 90 * @return void
Chris@0 91 */
Chris@0 92 public static function clean()
Chris@0 93 {
Chris@0 94 if (static::$stack) {
Chris@0 95 restore_error_handler();
Chris@0 96 }
Chris@0 97
Chris@0 98 static::$stack = [];
Chris@0 99 }
Chris@0 100
Chris@0 101 /**
Chris@0 102 * Add an error to the stack
Chris@0 103 *
Chris@0 104 * @param int $errno
Chris@0 105 * @param string $errstr
Chris@0 106 * @param string $errfile
Chris@0 107 * @param int $errline
Chris@0 108 * @return void
Chris@0 109 */
Chris@0 110 public static function addError($errno, $errstr = '', $errfile = '', $errline = 0)
Chris@0 111 {
Chris@0 112 $stack = & static::$stack[count(static::$stack) - 1];
Chris@0 113 $stack = new ErrorException($errstr, 0, $errno, $errfile, $errline, $stack);
Chris@0 114 }
Chris@0 115 }