Home Backend Development PHP Tutorial PHP exception handling related knowledge

PHP exception handling related knowledge

Jul 25, 2016 am 09:00 AM

  1. //create function with an exception
  2. function checkNum($number)
  3. {
  4. if($number>1)
  5. {
  6. throw new Exception("Value must be 1 or below") ;
  7. }
  8. return true;
  9. }
  10. //trigger exception
  11. checkNum(2);
  12. ?>
Copy code

The above code will get an error like this: Fatal error: Uncaught exception 'Exception' with message 'Value must be 1 or below' in C:webfoldertest.php:6 Stack trace: #0 C:webfoldertest.php(12): checkNum(28) #1 {main} thrown in C:webfoldertest.php on line 6 Try, throw and catch To avoid the errors in the above example, we need to create appropriate code to handle exceptions.

Processing procedures should include: Try - Functions that use exceptions should be inside a "try" block. If no exception is triggered, the code continues execution as usual. But if an exception is triggered, an exception will be thrown. Throw - This specifies how to trigger the exception. Each "throw" must correspond to at least one "catch" Catch - The "catch" code block will catch the exception and create an object containing the exception information

Let’s trigger an exception:

  1. //Create a function that can throw an exception
  2. function checkNum($number)
  3. {
  4. if($number>1)
  5. {
  6. throw new Exception("Value must be 1 or below");
  7. }
  8. return true;
  9. }
  10. //Trigger exception in "try" code block
  11. try
  12. {
  13. checkNum(2);
  14. //If the exception is thrown, this text will not be shown
  15. echo 'If you see this, the number is 1 or below';
  16. }
  17. //Catch exception
  18. catch(Exception $e)
  19. {
  20. echo 'Message: ' .$e->getMessage();
  21. }
  22. ?>
Copy the code

The above code will get an error similar to this: Message: Value must be 1 or below Example explanation: The code above throws an exception and catches it: Create checkNum() function. It detects whether the number is greater than 1. If so, throw an exception. Call the checkNum() function in the "try" block. Exception in checkNum() function is thrown The "catch" code block receives the exception and creates an object ($e) containing the exception information. Output the error message from this exception by calling $e->getMessage() from this exception object

However, in order to follow the principle of "each throw must correspond to a catch", you can set up a top-level exception handler to handle missed errors. Create a custom Exception class Creating custom exception handlers is very simple. We simply created a specialized class whose functions are called when an exception occurs in PHP. This class must be an extension of the exception class.

This custom exception class inherits all properties of PHP's exception class, and you can add custom functions to it.

We start creating the exception class:

  1. class customException extends Exception
  2. {
  3. public function errorMessage()
  4. {
  5. //error message
  6. $errorMsg = 'Error on line '.$this->getLine().' in '.$this->getFile()
  7. .': '.$this->getMessage().' is not a valid E-Mail address';
  8. return $errorMsg ;
  9. }
  10. }
  11. $email = "someone@example...com";
  12. try
  13. {
  14. //check if
  15. if(filter_var($email, FILTER_VALIDATE_EMAIL) === FALSE)
  16. {
  17. // throw exception if email is not valid
  18. throw new customException($email);
  19. }
  20. }
  21. catch (customException $e)
  22. {
  23. //display custom message
  24. echo $e->errorMessage();
  25. }
  26. ?>
Copy code

This new class is a copy of the old exception class, plus the errorMessage() function. Just because it is a copy of the old class, it inherits the properties and methods from the old class, and we can use the methods of the exception class, such as getLine(), getFile(), and getMessage(). Example explanation: The above code throws an exception and catches it through a custom exception class: The customException() class was created as an extension of the old exception class. This way it inherits all properties and methods of the old class. Create errorMessage() function. If the e-mail address is not valid, this function returns an error message Set the $email variable to an illegal e-mail address string Execute the "try" code block and throw an exception because the e-mail address is invalid The "catch" code block catches the exception and displays the error message

Multiple exceptions

You can use multiple exceptions for a script to detect multiple situations.

You can use multiple if..else code blocks, or a switch code block, or nest multiple exceptions. These exceptions can use different exception classes and return different error messages:

  1. class customException extends Exception
  2. {
  3. public function errorMessage()
  4. {
  5. //error message
  6. $errorMsg = 'Error on line '.$this->getLine().' in '.$this->getFile()
  7. .': '.$this->getMessage().' is not a valid E-Mail address';
  8. return $errorMsg ;
  9. }
  10. }
  11. $email = "someone@example.com";
  12. try
  13. {
  14. //check if
  15. if(filter_var($email, FILTER_VALIDATE_EMAIL) === FALSE)
  16. {
  17. //throw exception if email is not valid
  18. throw new customException($email);
  19. }
  20. //check for "example" in mail address
  21. if(strpos($email, "example") !== FALSE)
  22. {
  23. throw new Exception ("$email is an example e-mail");
  24. }
  25. }
  26. catch (customException $e)
  27. {
  28. echo $e->errorMessage();
  29. }
  30. catch(Exception $e)
  31. {
  32. echo $e->getMessage();
  33. }
  34. ?>
Copy code

Example explanation: The above code tests two conditions. If any condition is not true, an exception is thrown: The customException() class was created as an extension of the old exception class. This way it inherits all properties and methods of the old class. Create errorMessage() function. If the e-mail address is not valid, this function returns an error message. Execute the "try" block of code, and in the first condition, no exception will be thrown. Since the e-mail contains the string "example", the second condition triggers an exception. The "catch" code block will catch the exception and display the appropriate error message

If customException is not caught and base exception is caught tightly, the exception is handled there. Rethrow the exception

Sometimes, when an exception is thrown, you may want to handle it differently than the standard way. The exception can be thrown again in a "catch" block.

The script should hide system errors from the user. System errors may be important to programmers, but users are not interested in them. To make it easier for users, you can throw the exception again with a user-friendly message:

  1. class customException extends Exception
  2. {
  3. public function errorMessage()
  4. {
  5. //error message
  6. $errorMsg = $this->getMessage().' is not a valid E- Mail address.';
  7. return $errorMsg;
  8. }
  9. }
  10. $email = "someone@example.com";
  11. try
  12. {
  13. try
  14. {
  15. //check for "example" in mail address
  16. if( strpos($email, "example") !== FALSE)
  17. {
  18. //throw exception if email is not valid
  19. throw new Exception($email);
  20. }
  21. }
  22. catch(Exception $e)
  23. {
  24. / /re-throw exception
  25. throw new customException($email);
  26. }
  27. }
  28. catch (customException $e)
  29. {
  30. //display custom message
  31. echo $e->errorMessage();
  32. }
  33. ?> ;
Copy code

Example explanation: The above code detects whether the string "example" is contained in the email address. If so, throw the exception again: The customException() class was created as an extension of the old exception class. This way it inherits all properties and methods of the old class. Create errorMessage() function. If the e-mail address is not valid, this function returns an error message. Set the $email variable to a valid email address, but containing the string "example". A "try" block contains another "try" block so that the exception can be thrown again. The exception is triggered because the e-mail contains the string "example". "catch" catches the exception and rethrows "customException". A "customException" is caught and an error message is displayed.

If the exception is not caught in its current "try" block, it will look for a catch block at a higher level.

Set the Top Level Exception Handler

The set_exception_handler() function can set a user-defined function that handles all uncaught exceptions.

  1. function myException($exception)
  2. {
  3. echo "Exception: " , $exception->getMessage();
  4. }
  5. set_exception_handler( 'myException');
  6. throw new Exception('Uncaught Exception occurred');
  7. ?>
Copy code

The output of the above code should be similar to this: Exception: Uncaught Exception occurred In the above code, there is no "catch" block, instead the top-level exception handler is triggered. This function should be used to catch all uncaught exceptions. unusual rules Code that requires exception handling should be placed within a try block to catch potential exceptions. Every try or throw block must have at least one corresponding catch block. Use multiple catch blocks to catch different kinds of exceptions. Exceptions can be re-thrown in a catch block within a try block.

In short: if an exception is thrown, you must catch it.

Source: http://bbs.it-home.org/w3school/php/php_exception.html

Example:

  1. function throwTest($data)
  2. {
  3. try
  4. {
  5. if (!is_array($data) || emptyempty($data))
  6. {
  7. throw new Exception('data The type is not an array', 445);
  8. }
  9. echo('Done for testing!!');
  10. }
  11. catch (Exception $e)
  12. {
  13. /*echo 'Error message:',$e->getMessage( ), '
    ';//Error message
  14. echo '
    Error code:', $e->getCode(), '
    ';//Error code
  15. echo '
    Error file:', $e->getFile(), '
    ';//Error file
  16. echo '
    Error line number:', $e->getLine (), '
    ';//Error line number
  17. echo '
    Error information is displayed in an array:', print_r($e->getTrace()), '
    ' ;//Error information is displayed as an array
  18. echo '
    Error information is displayed as a string:', $e->getTraceAsString(), '
    ';//Error information is displayed as a string* /
  19. echo $e->getMessage(), '
    ';//Error message
  20. echo '
    ', $e->getTraceAsString(), '
    ' ;//Error information is displayed as a string
  21. exit;
  22. }
  23. }
  24. //$data=array("111","33333"); //Normal test
  25. $data="8129233"; //Abnormal test
  26. throwTest($data);
  27. ?>
Copy code

Articles you may be interested in: Example of using php exception handling class Exception PHP5 exception handling, error throwing and callback functions, etc. Exception handling, error throwing and error callback functions in php A simple php custom exception class Learn php errors and exception settings



Statement of this Website
The content of this article is voluntarily contributed by netizens, and the copyright belongs to the original author. This site does not assume corresponding legal responsibility. If you find any content suspected of plagiarism or infringement, please contact admin@php.cn

Hot AI Tools

Undresser.AI Undress

Undresser.AI Undress

AI-powered app for creating realistic nude photos

AI Clothes Remover

AI Clothes Remover

Online AI tool for removing clothes from photos.

Undress AI Tool

Undress AI Tool

Undress images for free

Clothoff.io

Clothoff.io

AI clothes remover

Video Face Swap

Video Face Swap

Swap faces in any video effortlessly with our completely free AI face swap tool!

Hot Tools

Notepad++7.3.1

Notepad++7.3.1

Easy-to-use and free code editor

SublimeText3 Chinese version

SublimeText3 Chinese version

Chinese version, very easy to use

Zend Studio 13.0.1

Zend Studio 13.0.1

Powerful PHP integrated development environment

Dreamweaver CS6

Dreamweaver CS6

Visual web development tools

SublimeText3 Mac version

SublimeText3 Mac version

God-level code editing software (SublimeText3)

Explain JSON Web Tokens (JWT) and their use case in PHP APIs. Explain JSON Web Tokens (JWT) and their use case in PHP APIs. Apr 05, 2025 am 12:04 AM

JWT is an open standard based on JSON, used to securely transmit information between parties, mainly for identity authentication and information exchange. 1. JWT consists of three parts: Header, Payload and Signature. 2. The working principle of JWT includes three steps: generating JWT, verifying JWT and parsing Payload. 3. When using JWT for authentication in PHP, JWT can be generated and verified, and user role and permission information can be included in advanced usage. 4. Common errors include signature verification failure, token expiration, and payload oversized. Debugging skills include using debugging tools and logging. 5. Performance optimization and best practices include using appropriate signature algorithms, setting validity periods reasonably,

How does session hijacking work and how can you mitigate it in PHP? How does session hijacking work and how can you mitigate it in PHP? Apr 06, 2025 am 12:02 AM

Session hijacking can be achieved through the following steps: 1. Obtain the session ID, 2. Use the session ID, 3. Keep the session active. The methods to prevent session hijacking in PHP include: 1. Use the session_regenerate_id() function to regenerate the session ID, 2. Store session data through the database, 3. Ensure that all session data is transmitted through HTTPS.

Describe the SOLID principles and how they apply to PHP development. Describe the SOLID principles and how they apply to PHP development. Apr 03, 2025 am 12:04 AM

The application of SOLID principle in PHP development includes: 1. Single responsibility principle (SRP): Each class is responsible for only one function. 2. Open and close principle (OCP): Changes are achieved through extension rather than modification. 3. Lisch's Substitution Principle (LSP): Subclasses can replace base classes without affecting program accuracy. 4. Interface isolation principle (ISP): Use fine-grained interfaces to avoid dependencies and unused methods. 5. Dependency inversion principle (DIP): High and low-level modules rely on abstraction and are implemented through dependency injection.

How to automatically set permissions of unixsocket after system restart? How to automatically set permissions of unixsocket after system restart? Mar 31, 2025 pm 11:54 PM

How to automatically set the permissions of unixsocket after the system restarts. Every time the system restarts, we need to execute the following command to modify the permissions of unixsocket: sudo...

How to debug CLI mode in PHPStorm? How to debug CLI mode in PHPStorm? Apr 01, 2025 pm 02:57 PM

How to debug CLI mode in PHPStorm? When developing with PHPStorm, sometimes we need to debug PHP in command line interface (CLI) mode...

Explain late static binding in PHP (static::). Explain late static binding in PHP (static::). Apr 03, 2025 am 12:04 AM

Static binding (static::) implements late static binding (LSB) in PHP, allowing calling classes to be referenced in static contexts rather than defining classes. 1) The parsing process is performed at runtime, 2) Look up the call class in the inheritance relationship, 3) It may bring performance overhead.

Framework Security Features: Protecting against vulnerabilities. Framework Security Features: Protecting against vulnerabilities. Mar 28, 2025 pm 05:11 PM

Article discusses essential security features in frameworks to protect against vulnerabilities, including input validation, authentication, and regular updates.

See all articles