International PHP Conference Berlin 2025

Exception::__construct

(PHP 5, PHP 7, PHP 8)

Exception::__constructConstrutor da exceção

Descrição

public Exception::__construct(string $message = "", int $code = 0, ?Throwable $previous = null)

Construtor de Exception.

Parâmetros

message

A mensagem da exceção.

code

O código da exceção.

previous

A exceção anterior, para o encadeamento de exceções.

Nota: Chamar o construtor da classe Exception de uma classe herdada faz ignorar os argumentos padrão, caso as propriedades $code e $message já estiverem configuradas.

Notas

Nota:

A message NÃO é binary safe.

adicione uma nota

Notas Enviadas por Usuários (em inglês) 2 notes

up
45
talksonweb at gmail dot com
11 years ago
For those that haven't done exception chaining. Here's an example.

This allows you to add the previous exception to the next one and give yourself detailed information in the end as to what happened. This is useful in larger applications.

<?php
function theDatabaseObj(){
if(
database_object ){
return
database_object;
}
else{
throw new
DatabaseException("Could not connect to the database");
}
}

function
updateProfile( $userInfo ){
try{
$db = theDatabaseObj();
$db->updateProfile();
}
catch(
DatabaseException $e ){
$message = "The user :" . $userInfo->username . " could not update his profile information";
/* notice the '$e'. I'm adding the previous exception to this exception. I can later get a detailed view of
where the problem began. Lastly, the number '12' is an exception code. I can use this for categorizing my
exceptions or don't use it at all. */
throw new MemberSettingsException($message,12,$e);
}
}

try{
updateProfile( $userInfo );
}
catch(
MemberSettingsException $e ){
// this will give all information we have collected above.
echo $e->getTraceAsString();
}
?>
up
1
mattsch at gmail dot com
11 years ago
Be aware that while $previous is quite useful in providing exception chaining and better traceability, none of the internal php exceptions (e.g. PDOException, ReflectionException, etc) are called internally within php with $previous in mind.

So if your code throws an exception, recovers from it, then catches one of these internal php exceptions, recovers from it and throws another exception, you will not know the first exception that was thrown when calling getPrevious.

See: https://bugs.php.net/bug.php?id=63873
To Top