Clase ErrorException

La clase ErrorException hereda de la clase base Exception y se utiliza para convertir errores de PHP en excepciones. Añade a la funcionalidad estándar de excepciones información sobre la gravedad del error (severity). La clase es especialmente útil cuando se usa con la función set_error_handler.

Sintaxis

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

Ejemplo

Creemos y manejemos una ErrorException:

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

Resultado de ejecutar el código:

'Error: Critical error Severity: 1'

Ejemplo

Convirtamos errores estándar de PHP en excepciones:

<?php
	function errorHandler($severity, $message, $file, $line) {
		throw new ErrorException($message, 0, $severity, $file, $line);
	}
	
	set_error_handler('errorHandler');
	
	try {
		strpos(); // Cantidad incorrecta de argumentos
	} catch (ErrorException $e) {
		echo 'Caught exception: ' . $e->getMessage();
		echo ' in ' . $e->getFile();
		echo ' on line ' . $e->getLine();
	}
?>

Resultado de ejecutar el código (ejemplo):

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

Ejemplo

Obtengamos información sobre la gravedad del error:

<?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');
	}
?>

Resultado de ejecutar el código:

'Severity level: 2 Is warning: yes'

Ver también

clase Exception,
clase base para todas las excepciones en PHP
función set_error_handler,
que establece un manejador de errores personalizado