set_exception_handler
Sets a user-defined exception handler function
&reftitle.description;
callableset_exception_handlercallableexception_handler
Sets the default exception handler if an exception is not caught within a
try/catch block. Execution will stop after the
exception_handler is called.
&reftitle.parameters;
exception_handler
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.
Note that providing an explicit Exception type
hint for the ex parameter in your callback will
cause issues with the changed exception hierarchy in PHP 7.
&reftitle.returnvalues;
Returns the name of the previously defined exception handler, or &null; on error. If
no previous handler was defined, &null; is also returned.
&reftitle.changelog;
&Version;&Description;7.0.0
The type of parameter passed into exception_handler changed
from Exception to Throwable5.5.0
Previously, if &null; was passed then this function returned &true;.
It returns the previous handler since PHP 5.5.0.
&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