If you intend on creating a lot of custom exceptions, you may find this code useful. I've created an interface and an abstract exception class that ensures that all parts of the built-in Exception class are preserved in child classes. It also properly pushes all information back to the parent constructor ensuring that nothing is lost. This allows you to quickly create new exceptions on the fly. It also overrides the default __toString method with a more thorough one.
/* Overrideable methods inherited from Exception class */public function__toString();// formated string for displaypublic function__construct($message=null,$code=0);
}
abstract classCustomExceptionextendsExceptionimplementsIException{
protected$message='Unknown exception';// Exception messageprivate$string;// Unknownprotected$code=0;// User-defined exception codeprotected$file;// Source filename of exceptionprotected$line;// Source line of exceptionprivate$trace;// Unknownpublic function__construct($message=null,$code=0)
{
if (!$message) {
throw new$this('Unknown '.get_class($this));
}parent::__construct($message,$code);
}
public function__toString()
{
returnget_class($this) ." '{$this->message}' in{$this->file}({$this->line})\n"."{$this->getTraceAsString()}";
}
}?>
Now you can create new exceptions in one line:
Here's a test that shows that all information is properly preserved throughout the backtrace.
{
try {
throw newTestException();
}
catch (TestException $e) {
echo"Caught TestException ('{$e->getMessage()}')\n{$e}\n";
}
catch (Exception $e) {
echo"Caught Exception ('{$e->getMessage()}')\n{$e}\n";
}
}
echo'
'.exceptionTest() .'';?>
Here's a sample output:
Caught TestException ('Unknown TestException')
TestException 'Unknown TestException' in C:\xampp\htdocs\CustomException\CustomException.php(31)
#0 C:\xampp\htdocs\CustomException\ExceptionTest.php(19): CustomException->__construct()
#1 C:\xampp\htdocs\CustomException\ExceptionTest.php(43): exceptionTest()
#2 {main}