Exceptions, Throwables & Custom Error Fences

In Plain English

Modern PHP handles errors and exceptions through the unified Throwable interface. Learn try...catch...finally blocks, throwing custom Exception classes, catching multiple exception types, and global error handling.

The Mental Model

"An exception is like an emergency stop cord on a train. When an impossible condition occurs (out of funds, database down), the conductor pulls the cord (throw), and the emergency response team (catch) safely evacuates passengers without a derailment."

Deep Dive: How It Works

The Throwable Hierarchy: Both Exception and Error (e.g. TypeError, ParseError) implement the Throwable interface.

Try-Catch-Finally: try runs code; catch intercepts matching exception types; finally executes cleanup unconditionally.

Custom Exceptions: Create domain exceptions by extending Exception (e.g. class PaymentFailedException extends Exception {}).

Exception Chaining: throw new ServiceException("Lookup failed", 0, $previousException) preserves root cause.

Syntax Blueprint

<?php

try {
    throw new InvalidArgumentException("Port must be positive");
} catch (InvalidArgumentException $e) {
    echo "Handled: " . $e->getMessage();
} finally {
    // Guaranteed cleanup
}

Wrap risky code in try blocks, handle specific exceptions in catch, and release resources in finally.

Core Rules to Remember

Catch Throwable: Catch Throwable to intercept both userland exceptions and PHP internal engine Errors.

Multiple Catch Blocks: Order catch blocks from most specific exception type to most generic.

Union Exceptions (PHP 8): catch (DbException | NetworkException $e) handles multiple exception types in a single block.

Common Beginner Traps & How to Fix Them

Mistake:Using empty catch (Exception $e) {} blocks that silently swallow errors.

Why it happens: Hides critical system failures and makes debugging impossible.

How to fix: Always log exceptions (error_log) or rethrow them if unrecoverable.

Pro Tip: Convert legacy PHP notices and warnings to ErrorException using set_error_handler() for 100% exception-driven architectures.

Live Interactive Example

Hit Run Code to see it live

Custom Exception and Safe Recovery Fence

PHP 8.2 / CLI

Output Console

Click "Run Code" to view the rendered output.

How it works: The invalid email threw ValidationException, safely intercepted by catch, followed by finally execution.

Your Turn: Micro Challenge

No pressure! Edit the starter code below and test your solution with instant feedback.

Micro Exercise

Throw and Catch Division by Zero Exception

Write a function safeDivide(float $a, float $b): float.
If $b == 0.0, throw new InvalidArgumentException("Division by zero").
Return $a / $b.
Wrap a call to safeDivide(10, 0) in a try-catch block and print "Error: " followed by the exception message.

Sandbox Output

Click "Run & Check" to test your solution.

Finished reading and practicing?

Mark this lesson as completed to update your course progress.