Classe Exception

A classe Exception representa a classe base para todas as exceções em PHP. Ela contém os métodos básicos para trabalhar com exceções: obter a mensagem de erro, código de erro, arquivo e linha onde a exceção foi lançada, bem como a pilha de chamadas. Ao criar uma exceção, você pode passar uma mensagem, um código de erro e a exceção anterior.

Sintaxe

new Exception(string $message = "", int $code = 0, Throwable $previous = null);

Exemplo

Vamos criar e tratar uma exceção simples:

<?php
	try {
		throw new Exception('Something went wrong', 100);
	} catch (Exception $e) {
		echo 'Error: ' . $e->getMessage();
	}
?>

Resultado da execução do código:

'Error: Something went wrong'

Exemplo

Vamos usar os principais métodos da classe Exception:

<?php
	try {
		throw new Exception('Test exception', 123);
	} catch (Exception $e) {
		echo 'Message: ' . $e->getMessage() . "\n";
		echo 'Code: ' . $e->getCode() . "\n";
		echo 'File: ' . $e->getFile() . "\n";
		echo 'Line: ' . $e->getLine() . "\n";
	}
?>

Resultado da execução do código (exemplo):

'Message: Test exception
Code: 123
File: /path/to/file.php
Line: 3'

Exemplo

Vamos obter a pilha de chamadas quando uma exceção é lançada:

<?php
	function test() {
		throw new Exception('Stack trace test');
	}
	
	try {
		test();
	} catch (Exception $e) {
		print_r($e->getTrace());
	}
?>

Resultado da execução do código (exemplo):

[
	[
		'file' => '/path/to/file.php',
		'line' => 5,
		'function' => 'test',
		'args' => []
	]
]

Veja também

a classe ErrorException,
que representa erros como exceções
a função set_exception_handler,
que define um manipulador de exceções personalizado