set_exception_handler
Sets a user-defined exception handler function
&reftitle.description;
stringarrayobjectnullset_exception_handlercallablenullcallback
Sets the default exception handler if an exception is not caught within a
try/catch block. Execution will stop after the
callback is called.
&reftitle.parameters;
callback
Name of the function to be called when an uncaught exception occurs.
This handler function
needs to accept one parameter, which will be the exception object that
was thrown. This is the handler signature before PHP 7:
voidhandlerExceptionex
Since PHP 7, most errors are reported by throwing Error
exceptions, which will be caught by the handler as well. Both Error
and Exception implements the Throwable interface.
This is the handler signature since PHP 7:
voidhandlerThrowableex
&null; may be passed instead, to reset this handler to its default state.
&reftitle.returnvalues;
Returns the previously defined exception handler, or &null; on error. If
no previous handler was defined, &null; is also returned.
&reftitle.examples;
set_exception_handler example
getMessage(), "\n";
}
set_exception_handler('exception_handler');
throw new Exception('Uncaught Exception');
echo "Not Executed\n";
?>
]]>
&reftitle.seealso;
restore_exception_handlerrestore_error_handlererror_reportingPHP 5 Exceptions