19.8.11 Custom exception handlers: set_exception_handler() and restore_exception_handler()This is NOT the latest copy of this book; click here for the latest version.
string set_exception_handler ( string exception_handler)
void restore_exception_handler ( void )
In the same way that set_error_handler() sets a handler for uncaught errors, set_exception_handler() sets a handler for uncaught exceptions. As exceptions are more powerful than errors, your exception-handling function need only take one parameter: an exception object. From that you can glean the usual information such as message, line number, etc.
Apart from the parameters passed, these work the same as set_error_handler(). Here's an example:
<?php
function handle_exception($exception) {
echo "Caught exception: {$exception->getMessage()}\n";
}
set_exception_handler("handle_exception");
throw(new Exception('The engines cannie take much more!'));
?>
Having a custom exception handler is actually a smart move wherever you're using exceptions, because it essentially captures all exceptions that would otherwise have been uncaught, and gives you one last chance to take some action before the script potentially terminates.
|
Want to see this stuff in print? PHP in a Nutshell takes the core topics covered here, adds in thousands of edits from the editorial team and myself, and combines them to make an unbeatable reference for PHP programmers at all levels.
My latest book has hundreds more tips on how to use PHP, Apache, and MySQL, plus Perl, Python, shell scripts, performance tuning, and more!
|
