Исключения PHP: полный разбор механизмов и сценарии использования

Расширенные примеры обработки исключений

Пример 1: Цепочка исключений (previous)

При повторном выбрасывании исключения можно передать предыдущее, чтобы сохранить контекст.

function processData($data) {
    try {
        // операция, которая может выбросить InvalidArgumentException
        if ($data === null) {
            throw new InvalidArgumentException('Данные отсутствуют');
        }
        return $data * 2;
    } catch (InvalidArgumentException $e) {
        throw new RuntimeException('Не удалось обработать данные', 0, $e);
    }
}

try {
    $result = processData(null);
} catch (RuntimeException $e) {
    echo 'Сообщение: ' . $e->getMessage();
    echo '\nПредыдущее исключение: ' . $e->getPrevious()->getMessage();
}

Сообщение: Не удалось обработать данные
Предыдущее исключение: Данные отсутствуют

Пример 2: Исключения в анонимных функциях и замыканиях

Анонимные функции могут выбрасывать исключения, которые перехватываются во внешнем коде.

$handler = function($value) {
    if ($value < 0) {
        throw new OutOfBoundsException('Значение вне диапазона');
    }
    return sqrt($value);
};

try {
    echo $handler(-4);
} catch (OutOfBoundsException $e) {
    echo 'Ошибка: ' . $e->getMessage();
}

Ошибка: Значение вне диапазона

Пример 3: Исключения в рекурсивных функциях

Рекурсия может быть прервана исключением, которое поднимается по стеку.

function factorial($n) {
    if ($n < 0) {
        throw new RangeException('Факториал отрицательного числа не определён');
    }
    if ($n <= 1) {
        return 1;
    }
    return $n * factorial($n - 1);
}

try {
    echo factorial(-5);
} catch (RangeException $e) {
    echo 'Ошибка: ' . $e->getMessage();
}

Ошибка: Факториал отрицательного числа не определён

Пример 4: Кастомные исключения с дополнительными свойствами

Добавление полей для детализации ошибки.

class ValidationException extends Exception {
    private $field;
    public function __construct($message, $field, $code = 0, Throwable $previous = null) {
        parent::__construct($message, $code, $previous);
        $this->field = $field;
    }
    public function getField() {
        return $this->field;
    }
}

try {
    $data = ['name' => ''];
    if (empty($data['name'])) {
        throw new ValidationException('Имя обязательно', 'name');
    }
} catch (ValidationException $e) {
    echo 'Поле ' . $e->getField() . ': ' . $e->getMessage();
}

Поле name: Имя обязательно

Пример 5: Обработка исключений из трейтов

Трейты могут содержать код, выбрасывающий исключения. Обрабатывать их нужно в классе, использующем трейт.

trait FileLogger {
    public function log($message) {
        if (!is_writable('log.txt')) {
            throw new RuntimeException('Лог-файл не доступен для записи');
        }
        file_put_contents('log.txt', $message . PHP_EOL, FILE_APPEND);
    }
}

class Application {
    use FileLogger;
    public function run() {
        try {
            $this->log('Старт приложения');
        } catch (RuntimeException $e) {
            echo 'Проблема с логированием: ' . $e->getMessage();
        }
    }
}

$app = new Application();
$app->run();

(если файл недоступен) Проблема с логированием: Лог-файл не доступен для записи

Пример 6: Исключения в контексте транзакций баз данных

При ошибке в БД откатываем транзакцию и выбрасываем исключение.

$pdo = new PDO('mysql:host=localhost;dbname=test', 'user', 'pass');
$pdo->beginTransaction();
try {
    $pdo->exec('UPDATE accounts SET balance = balance - 100 WHERE id = 1');
    $pdo->exec('UPDATE accounts SET balance = balance + 100 WHERE id = 2');
    $pdo->commit();
} catch (PDOException $e) {
    $pdo->rollBack();
    echo 'Транзакция отменена: ' . $e->getMessage();
}

(при ошибке) Транзакция отменена: ...

Пример 7: Использование expect в PHPUnit для проверки исключений

Юнит-тесты часто требуют проверки, что код выбрасывает определённое исключение.

use PHPUnit\Framework\TestCase;

class CalculatorTest extends TestCase {
    public function testDivisionByZero() {
        $this->expectException(DivisionByZeroError::class);
        $calculator = new Calculator();
        $calculator->divide(10, 0);
    }
}

Тест пройден, если выбрасывается DivisionByZeroError.