Класс ErrorException

Класс ErrorException наследуется от базового класса Exception и используется для преобразования ошибок PHP в исключения. Он добавляет к стандартному функционалу исключений информацию о серьезности ошибки (severity). Класс особенно полезен при использовании с функцией set_error_handler.

Синтаксис

phpnew ErrorException(
  string $message = "",
  int $code = 0,
  int $severity = E_ERROR,
  string $filename = __FILE__,
  int $lineno = __LINE__,
  Throwable $previous = null
);

Пример

Создадим и обработаем ErrorException:

php<?php
  try {
    throw new ErrorException('Critical error', 0, E_ERROR);
  } catch (ErrorException $e) {
    echo 'Error: ' . $e->getMessage();
    echo ' Severity: ' . $e->getSeverity();
  }
?>

Результат выполнения кода:

php'Error: Critical error Severity: 1'

Пример

Преобразуем стандартные ошибки PHP в исключения:

php<?php
  function errorHandler($severity, $message, $file, $line) {
    throw new ErrorException($message, 0, $severity, $file, $line);
  }
  
  set_error_handler('errorHandler');
  
  try {
    strpos(); // Неправильное количество аргументов
  } catch (ErrorException $e) {
    echo 'Caught exception: ' . $e->getMessage();
    echo ' in ' . $e->getFile();
    echo ' on line ' . $e->getLine();
  }
?>

Результат выполнения кода (пример):

php'Caught exception: strpos() expects at least 2 parameters, 0 given in /path/to/file.php on line 10'

Пример

Получим информацию о серьезности ошибки:

php<?php
  try {
    throw new ErrorException('Warning message', 0, E_WARNING);
  } catch (ErrorException $e) {
    echo 'Severity level: ' . $e->getSeverity();
    echo ' Is warning: ' . ($e->getSeverity() === E_WARNING ? 'yes' : 'no');
  }
?>

Результат выполнения кода:

php'Severity level: 2 Is warning: yes'

Смотрите также

  • класс Exception,
    базовый класс для всех исключений в PHP
  • функцию set_error_handler,
    которая устанавливает пользовательский обработчик ошибок