Exception::getPrevious
(PHP 5 >= 5.3.0)
Exception::getPrevious — Возвращает предыдущее исключение
Описание
Возвращает предыдущее исключение (переданное третьим параметром в Exception::__construct()).
Список параметров
У этой функции нет параметров.
Возвращаемые значения
Возвращает предыдущее исключение(Exception) или NULL
если такового нет.
Примеры
Пример #1 Пример использования Exception::getPrevious()
Проходим по всем исключениям и поочередно выводим их
<?php
class MyCustomException extends Exception {}
function doStuff() {
try {
throw new InvalidArgumentException("Ты делаешь это неправильно!", 112);
} catch(Exception $e) {
throw new MyCustomException("Что-то случилось", 911, $e);
}
}
try {
doStuff();
} catch(Exception $e) {
do {
printf("%s:%d %s (%d) [%s]\n", $e->getFile(), $e->getLine(), $e->getMessage(), $e->getCode(), get_class($e));
} while($e = $e->getPrevious());
}
?>
Результатом выполнения данного примера будет что-то подобное:
/home/bjori/ex.php:8 Что-то случилось (911) [MyCustomException] /home/bjori/ex.php:6 Ты делаешь это неправильно! (112) [InvalidArgumentException]
- Функция Exception::__construct() - Создать исключение
- Функция Exception::getMessage() - Получает сообщение исключения
- Функция Exception::getPrevious() - Возвращает предыдущее исключение
- Функция Exception::getCode() - Получает код исключения
- Функция Exception::getFile() - Получает файл, в котором возникло исключение
- Функция Exception::getLine() - Получает строку, в которой возникло исключение
- Функция Exception::getTrace() - Получает трассировку стека
- Функция Exception::getTraceAsString() - Получает трассировку стека в виде строки
- Функция Exception::__toString() - Строковое представление исключения
- Функция Exception::__clone() - Клонировать исключение
Коментарии
May be I am late (5.2 is not supported). But if you want use the functionality of "previous Exception" in PHP < 5.3 or write compatible code, you can use next way as below.
<?php
abstract class App_Exception_PreviousNativeAbstract extends Exception {
public static $printPrevious = true;
public function __toString() {
$result = array();
$result[] = sprintf("Exception '%s' with message '(%s) %s' in %s:%d", get_class($this), $this->code, $this->message, $this->file, $this->line);
$result[] = '---[Stack trace]:';
$result[] = $this->getTraceAsString();
if (self::$printPrevious) {
$previous = $this->getPrevious();
if ($previous) {
do {
$result[] = '---[Previous exception]:';
$result[] = sprintf("Exception '%s' with message '(%s) %s' in %s:%d", get_class($previous), $previous->getCode(), $previous->getMessage(), $previous->getFile(), $previous->getLine());
$result[] = '---[Stack trace]:';
$result[] = $previous->getTraceAsString();
} while(method_exists($previous, 'getPrevious') && ($previous = $previous->getPrevious()));
}
}
return implode("\r\n", $result);
}
}
abstract class App_Exception_PreviousLegacyAbstract extends App_Exception_PreviousNativeAbstract {
protected $previous;
public function __construct($message, $code = 0, Exception $previous = null) {
$this->previous = $previous;
parent::__construct($message, $code);
}
public function getPrevious() {
return $this->previous;
}
}
if (version_compare(PHP_VERSION, '5.3.0', '>=')) {
abstract class App_Exception_PreviousAbstract extends App_Exception_PreviousNativeAbstract {}
}
else {
abstract class App_Exception_PreviousAbstract extends App_Exception_PreviousLegacyAbstract {}
}
class App_Exception extends App_Exception_PreviousAbstract {
public function __construct($message, $code = 0, Exception $previous = null) {
parent::__construct($message, 0, $previous);
}
}
// Example:
try {
// ...
throw new Exception('Exception mesage');
// ...
} catch (Exception $e) {
throw new App_Exception('App exception mesage', 0, $e);
}
?>
/**
* Gets sequential array of all previously-chained errors
*
* @param Throwable $error
*
* @return Throwable[]
*/
function getChain(Throwable $error) : array
{
$chain = [];
do {
$chain[] = $error;
} while ($error = $error->getPrevious());
return $chain;
}