Exceptions

Prior to version 7, PHP parser used to report errors in response to various conditions. Each error used to be of a certain predefined type. PHP7 has changed the mechanism of error reporting. Instead of traditional error reporting, most errors are now reported by throwing error exceptions.

The exception handling mechanism in PHP is similar to many other languages, and is implemented with the try, catch, throw and finally keywords.

The Throwable Interface

Exceptions in PHP implements the Throwable interface. The Throwable interface acts as the base for any object that can be thrown via throw statement, including Error and Exception objects.

A user defined class cannot implement Throwable interface directly. Instead, to declare a user defined exception class, it must extend the Exception class.

PHP code with potential exceptions is surrounded in a try block. An exception object is thrown if it is found, to facilitate the catching of potential exceptions. Each try must have at least one corresponding catch or finally block. Moreover, there may be more than one catch/finally blocks corresponding to a try block.

try{// throw errors in the try-block // if an error occurs we can throw an exceptionthrownewException('this is an error.');}catch(Exception$e){// catch the throws in the catch-block // do something with the exception object, eg.  // display its messageecho'Error message: '.$e->getMessage();}

If an exception is thrown and there is no catch block, the exception will “bubble up” until it finds a matching catch block. If the call stack is unwound all the way to the global scope without encountering a matching catch block, a global exception handler will be called (if it is set) otherwise the program will terminate with a fatal error.

set_exception_handler

This function sets the default exception handler if an exception is not caught within a try/catch block. After the callback is executed, the program execution will stop.

set_exception_handler(?callable$callback):?callable

The $callback parameter is the name of the function to be called when an uncaught exception occurs. This function must be defined before calling set_exception_handler(). This handler function needs to accept one parameter, which will be the exception object that was thrown.

The function returns the name of the previously defined exception handler, or NULL on error. If no previous handler was defined, NULL is also returned.

Example

Take a look at the following example −

Open Compiler

<?php
   function handler($ex) {
      echo "Uncaught exception is : " , $ex->getMessage(), "\n";
   }

   set_exception_handler('handler');
   throw new Exception('Not Found Exception');
   echo "not included Executed\n";
?>

It will produce the following output −

Uncaught exception is : Not Found Exception

Explore our latest online courses and learn new skills at your own pace. Enroll and become a certified expert to boost your career.

SPL Exceptions

Standard PHP library contains predefined exceptions −

Sr.No	Predefined Exceptions
1	LogicExceptionException that represents error in the program logic.
2	BadFunctionCallExceptionException thrown if a callback refers to an undefined function or if some arguments are missing.
3	BadMethodCallExceptionException thrown if a callback refers to an undefined method or if some arguments are missing.
4	DomainExceptionException thrown if a value does not adhere to a defined valid data domain.
5	InvalidArgumentExceptionException thrown if an argument is not of the expected type.
6	LengthExceptionException thrown if a length is invalid.
7	OutOfRangeExceptionException thrown when an illegal index was requested.
8	RuntimeExceptionException thrown if an error which can only be found on runtime occurs.
9	OutOfBoundsExceptionException thrown if a value is not a valid key.
10	OverflowExceptionException thrown when adding an element to a full container.
11	RangeExceptionException thrown to indicate range errors during program execution. An arithmetic error other than under/overflow.
12	UnderflowExceptionException thrown when performing an invalid operation on an empty container, such as removing an element.
13	UnexpectedValueExceptionException thrown if a value does not match with a set of values.

User-defined Exception

You can define a custom exception class that extends the base Exception class. Following script defines a custom exception class called myException. This type of exception is thrown if value of $num is less than 0 or greater than 100.

Example

The getMessage() method of Exception class returns the error message and getLine() method returns line of code in which exception appears.

Open Compiler

<?php
   class myException extends Exception {
      function message() {
         return "error : ". $this->getMessage(). "in line no". $this->getLine();
      }
   }
   $num=125;
   try {
      if ($num>100 || $num<0)
      throw new myException("$num is invalid number");
      else
      echo "$num is a valid number";
   }
   catch (myException $m) {
      echo $m->message();
   }
?>

Run the above code with $num=125 and $num=90 to get an error message and a message of valid number −

error : 125 is invalid number in line no 10