Error Handling and Debugging in PHP

# CHAPTER 16

Error Handling and Debugging in PHP #

1. Introduction #

2. Learning Objectives #

• Understand the difference between Notices, Warnings, and Fatal Errors.

• Enable error reporting for local development.

• Implement robust try...catch blocks for Exception handling.

• Write custom error messages to secure server logs.

3. Beginner-Friendly Explanation #

• A Notice: The dashboard says you are low on windshield wiper fluid. The car still drives perfectly fine, but you should probably fix it.

• A Warning: The "Check Engine" light turns on. The car is still moving, but something is wrong under the hood. It might break down soon.

• A Fatal Error: The engine explodes. The car immediately stops.

4. PHP Error Types #

1. 1. Notices: Minor, non-fatal issues (e.g., trying to echo an undefined variable). The script continues executing.

1. 2. Warnings: More serious issues (e.g., include('missing_file.php')). The script continues executing, but part of the page might be broken.

1. 3. Fatal Errors: Critical issues (e.g., calling a function that doesn't exist, or missing a semicolon). The script completely stops executing immediately.

5. Enabling Error Reporting #

<?php
// Display all errors on the screen (FOR DEVELOPMENT ONLY)
error_reporting(E_ALL);
ini_set(&#039;display_errors', 1);

// This will cause a Notice because $fake_variable doesn't exist
echo $fake_variable;
?>

6. Exception Handling (try...catch) #

<?php
function divideNumbers($numerator, $denominator) {
    if ($denominator == 0) {
        // We throw an exception instead of letting PHP crash
        throw new Exception("Division by zero is mathematically impossible.");
    }
    return $numerator / $denominator;
}

// The 'try' block runs the dangerous code
try {
    echo divideNumbers(10, 0);
    echo "This line will never execute because the error stops it.";
} 
// The 'catch' block safely catches the explosion and handles it
catch (Exception $e) {
    echo "An error occurred: " . $e->getMessage();
}

// Because we caught the error, the website CONTINUES running!
echo "<p>Welcome to the rest of the website!</p>";
?>

7. Logging Errors (The Production Workflow) #

<?php
// Turn off screen display
ini_set(&#039;display_errors', 0);
// Turn on hidden logging
ini_set(&#039;log_errors', 1);
// Specify the hidden file
ini_set(&#039;error_log', '/var/log/php_errors.log');

// If this crashes, the user sees a blank page or a friendly "Oops" message,
// but the developer can open php_errors.log to see the exact stack trace.
?>

8. Basic Debugging Tools: var_dump() #

<?php
$user = ["name" => "Alice", "role" => "Admin"];

// Prints the exact structure, data type, and length of the variable to the screen
var_dump($user);

// To stop the script immediately after dumping (so HTML doesn't distract you)
die(); 
?>

9. Best Practices #

• Custom 404/500 Pages: Use your try...catch blocks to redirect users to a beautifully designed "Oops, something went wrong" page, rather than showing them a broken layout.

10. Common Mistakes #

• Leaving display_errors On in Production: This is a severe security vulnerability. Error traces reveal server file paths (C:\xampp\htdocs\...), database table names, and sometimes API keys. Always log errors in production; never display them.

11. Exercises #

1. 1. Explain the functional difference between a PHP Warning and a PHP Fatal Error regarding script execution.

12. Coding Challenges #

• Challenge: Write a try...catch block around a PDO database connection. If the connection fails, use the error_log() function to save the message "Database connection failed!" to the server log, and echo a friendly message to the user saying "Our servers are currently undergoing maintenance."

13. MCQs with Answers #

14. Interview Questions #

• Q: Differentiate between error handling in a local development environment versus a live production environment. What php.ini settings change?

• Q: How do you debug an array or object to inspect its contents during runtime? What functions are available in PHP?

15. FAQs #

16. Summary #

17. Next Chapter Recommendation #