Custom exception handlers

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 cannae 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 learn PHP 7?

Hacking with PHP has been fully updated for PHP 7, and is now available as a downloadable PDF. Get over 1200 pages of hands-on PHP learning today!

If this was helpful, please take a moment to tell others about Hacking with PHP by tweeting about it!

Next chapter: Using @ to disable errors >>

Previous chapter: Custom error handlers

Jump to:

Home: Table of Contents