питон либ луна питонлиб солнце progerlib цветок

Thema wechseln

Anmelden Registrierung
🐘 PHP

Fehlerbehandlung und Ausnahmen in PHP: Eine ausführliche Anleitung

Lektion 19 / 35 • Vollständige Lektüre-Theorie

Что это такое и зачем? (аналогия из реальной жизни)

Представь, что ты — капитан космического корабля. Твой корабль летит к далёкой звезде. Вдруг на приборной панели загорается красная лампочка: «Перегрев двигателя!». Что ты сделаешь? Если ты просто проигнорируешь сигнал и продолжишь полёт, корабль взорвётся. Но если у тебя есть план действий на случай аварии — ты включишь резервное охлаждение, снизишь скорость и отправишь сигнал бедствия. Корабль будет спасён.

В программировании происходит то же самое. Твой код — это космический корабль. Ошибки — это те самые красные лампочки. А обработка ошибок и исключений — это твой аварийный план. Без него любая мелкая неполадка (например, пользователь ввёл букву вместо числа) может «взорвать» программу — то есть показать пользователю страшную техническую ошибку и остановить работу сайта.

Давай разберёмся на бытовом примере. Ты заказываешь пиццу через интернет. Вводишь свой адрес: «ул. Ленина, д. 5». Всё хорошо. Но что, если ты случайно введёшь «ул. Ленина, дом 5, подъезд 3, квартира 12, этаж 5, код домофона 1234»? Программа может запутаться. Если она не умеет обрабатывать такие ситуации, она просто вылетит с ошибкой. А если умеет — она скажет: «Извините, адрес слишком длинный. Пожалуйста, введите только улицу и номер дома». Это и есть обработка исключений.

Обработка ошибок — это не про то, как избежать ошибок. Это про то, как достойно из них выбраться, когда они уже случились. А они случаются всегда.

Теория: как это работает изнутри

В PHP существует два основных механизма для работы с проблемами: ошибки (errors) и исключения (exceptions). Это не одно и то же, хотя новички часто их путают.

Ошибки (Errors)

Ошибки — это серьёзные проблемы. Например, ты пытаешься вызвать функцию, которой не существует, или подключить файл, которого нет на сервере. PHP в этом случае паникует и выдаёт сообщение об ошибке. Ошибки бывают разных уровней: от лёгких предупреждений (Warning) до фатальных (Fatal Error), после которых скрипт умирает окончательно.

Раньше (в PHP 4 и 5) ошибки нельзя было «поймать» как исключения. Они просто выводились на экран. Но с PHP 7 появилась возможность превращать большинство ошибок в исключения с помощью специального класса Error. Это сделало язык более современным и безопасным.

Исключения (Exceptions)

Исключения — это более «культурный» способ сообщить о проблеме. Ты сам решаешь, когда и какую проблему считать исключительной ситуацией. Например, если пользователь ввёл отрицательное число, а возраст не может быть отрицательным — ты можешь «выбросить» (throw) исключение. Исключение — это специальный объект, который содержит информацию об ошибке: текст сообщения, код ошибки, файл и строку, где она произошла.

Когда исключение выбрасывается, PHP немедленно останавливает выполнение текущего блока кода и начинает искать «ловушку» (catch). Если ловушка найдена — управление передаётся ей, и программа продолжает работу. Если нет — PHP выдаёт фатальную ошибку.

Как это выглядит внутри PHP?

Представь, что твоя программа — это многоэтажный дом. Код выполняется на первом этаже. Если происходит ошибка, PHP кричит: «Пожар!». Все жильцы (функции) должны немедленно покинуть здание. Но если у тебя есть план эвакуации (блок try-catch), ты спокойно выводишь людей через запасной выход, а не прыгаешь из окна.

В PHP 7+ иерархия исключений выглядит так:

  • Throwable — интерфейс, который объединяет всё, что можно выбросить (throw).
  • Error — базовый класс для системных ошибок (например, нехватка памяти).
  • Exception — базовый класс для исключений, которые создаёт программист.

Это значит, что теперь ты можешь ловить и ошибки, и исключения одним блоком try-catch. Но об этом позже.

Синтаксис в PHP: все формы и варианты

Давай разберём все конструкции, которые PHP предоставляет для работы с исключениями. Их не так много, но каждая важна.

1. Блок try-catch

Это основа основ. Ты говоришь PHP: «Попробуй выполнить этот код (try). Если что-то пойдёт не так — лови исключение (catch) и делай вот это».

try {
    // Код, который может выбросить исключение
    $result = 10 / 0; // Деление на ноль — это исключение
} catch (DivisionByZeroError $e) {
    // Что делать, если поймали исключение
    echo "Ошибка: деление на ноль!";
}

2. Блок finally

Этот блок выполняется ВСЕГДА — и если исключение было, и если его не было. Он нужен для «уборки»: закрыть файл, закрыть соединение с базой данных, освободить память.

try {
    // Открываем файл
    $file = fopen("test.txt", "r");
    // Читаем файл...
} catch (Exception $e) {
    echo "Не удалось прочитать файл";
} finally {
    // Этот код выполнится в любом случае
    if (isset($file)) {
        fclose($file);
    }
    echo "Файл закрыт";
}

3. Выбрасывание исключения (throw)

Ты можешь сам создать исключение в любой момент. Для этого используется ключевое слово throw и оператор new для создания объекта исключения.

function checkAge($age) {
    if ($age < 0) {
        throw new InvalidArgumentException("Возраст не может быть отрицательным!");
    }
    if ($age > 150) {
        throw new OutOfRangeException("Столько не живут!");
    }
    return "Возраст корректен";
}

4. Несколько блоков catch

Ты можешь ловить разные типы исключений по-разному. Это как разные планы эвакуации для пожара и для наводнения.

try {
    // Какой-то код
} catch (InvalidArgumentException $e) {
    echo "Проблема с аргументами: " . $e->getMessage();
} catch (RuntimeException $e) {
    echo "Ошибка выполнения: " . $e->getMessage();
} catch (Exception $e) {
    // Ловим всё остальное
    echo "Неизвестная ошибка: " . $e->getMessage();
}
Важно: порядок блоков catch имеет значение! Сначала ловим более конкретные исключения, потом — более общие. Если поставить Exception первым, он поймает всё, и остальные блоки никогда не сработают.

5. Создание своих классов исключений

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

class MyCustomException extends Exception {
    // Можно добавить свои свойства и методы
    private $errorCode;
    
    public function __construct($message, $code = 0, $errorCode = 0) {
        parent::__construct($message, $code);
        $this->errorCode = $errorCode;
    }
    
    public function getErrorCode() {
        return $this->errorCode;
    }
}

// Использование
try {
    throw new MyCustomException("Что-то пошло не так", 0, 404);
} catch (MyCustomException $e) {
    echo "Код ошибки: " . $e->getErrorCode();
}

6. Глобальный обработчик исключений

Если ты не поймал исключение в коде, PHP вызовет глобальный обработчик. Его можно установить с помощью функции set_exception_handler().

function globalExceptionHandler($exception) {
    echo "Непойманное исключение: " . $exception->getMessage();
    // Здесь можно записать ошибку в лог, отправить письмо администратору и т.д.
}

set_exception_handler('globalExceptionHandler');

// Теперь любое непойманное исключение попадёт в эту функцию
throw new Exception("Тест глобального обработчика");

7. Обработка ошибок (не исключений)

Для старых ошибок (Warning, Notice) существует функция set_error_handler(). Она превращает ошибки в исключения.

function errorHandler($severity, $message, $file, $line) {
    throw new ErrorException($message, 0, $severity, $file, $line);
}

set_error_handler('errorHandler');

// Теперь любая ошибка станет исключением
try {
    echo $undefinedVariable; // Notice превратится в исключение
} catch (ErrorException $e) {
    echo "Поймали ошибку: " . $e->getMessage();
}

Примеры кода — от простого к сложному

Теперь давай посмотрим на живые примеры. Каждый пример — рабочий, с объяснением каждой строки.

Пример 1: Деление на ноль (самое простое)

// Пытаемся разделить число на ноль
try {
    // Это вызовет исключение DivisionByZeroError
    $result = 10 / 0;
    // Эта строка НЕ выполнится, если было исключение
    echo "Результат: $result";
} catch (DivisionByZeroError $e) {
    // Ловим исключение и выводим сообщение
    echo "Ошибка: делить на ноль нельзя!";
}
// Программа продолжает работу
echo "Программа завершена успешно";

Пример 2: Проверка возраста пользователя

// Функция проверки возраста
function validateAge($age) {
    // Если возраст меньше 0 или больше 150 — это ошибка
    if ($age < 0 || $age > 150) {
        // Создаём и выбрасываем исключение
        throw new InvalidArgumentException("Некорректный возраст: $age");
    }
    // Если всё хорошо — возвращаем true
    return true;
}

// Используем функцию
try {
    // Пробуем проверить возраст
    validateAge(-5);
    echo "Возраст корректен"; // Эта строка не выполнится
} catch (InvalidArgumentException $e) {
    // Ловим исключение и выводим сообщение
    echo "Ошибка: " . $e->getMessage();
}

Пример 3: Работа с файлами

// Пытаемся открыть несуществующий файл
try {
    // Пробуем открыть файл для чтения
    $file = fopen("несуществующий_файл.txt", "r");
    
    // Если файл не открылся — выбрасываем исключение
    if (!$file) {
        throw new Exception("Не удалось открыть файл");
    }
    
    // Читаем файл (эта строка не выполнится, если файл не открылся)
    $content = fread($file, filesize("несуществующий_файл.txt"));
    echo $content;
    
} catch (Exception $e) {
    // Ловим исключение
    echo "Произошла ошибка: " . $e->getMessage();
} finally {
    // Этот блок выполнится всегда
    if (isset($file) && $file) {
        fclose($file);
        echo "Файл закрыт";
    } else {
        echo "Файл не был открыт";
    }
}

Пример 4: Калькулятор с обработкой ошибок

// Функция-калькулятор
function calculate($a, $b, $operation) {
    // Проверяем, что оба аргумента — числа
    if (!is_numeric($a) || !is_numeric($b)) {
        throw new InvalidArgumentException("Оба аргумента должны быть числами");
    }
    
    // Выполняем операцию
    switch ($operation) {
        case '+':
            return $a + $b;
        case '-':
            return $a - $b;
        case '*':
            return $a * $b;
        case '/':
            // Проверяем деление на ноль
            if ($b == 0) {
                throw new DivisionByZeroError("Деление на ноль невозможно");
            }
            return $a / $b;
        default:
            // Неизвестная операция
            throw new InvalidArgumentException("Неизвестная операция: $operation");
    }
}

// Используем калькулятор
try {
    echo calculate(10, 0, '/'); // Попробуйте изменить операцию
} catch (DivisionByZeroError $e) {
    echo "Ошибка: " . $e->getMessage();
} catch (InvalidArgumentException $e) {
    echo "Ошибка: " . $e->getMessage();
} catch (Exception $e) {
    echo "Неизвестная ошибка: " . $e->getMessage();
}

Пример 5: Соединение с базой данных (имитация)

// Имитация подключения к БД
class DatabaseConnection {
    private $connected = false;
    
    public function connect($host, $user, $password) {
        // Имитируем успешное подключение
        $this->connected = true;
        return true;
    }
    
    public function query($sql) {
        // Если нет подключения — ошибка
        if (!$this->connected) {
            throw new RuntimeException("Нет подключения к базе данных");
        }
        
        // Имитируем ошибку SQL
        if (strpos($sql, 'DROP') !== false) {
            throw new Exception("Опасный SQL-запрос заблокирован");
        }
        
        return "Результат запроса";
    }
    
    public function disconnect() {
        $this->connected = false;
    }
}

// Используем класс
$db = new DatabaseConnection();

try {
    $db->connect("localhost", "root", "password");
    echo $db->query("SELECT * FROM users");
    echo $db->query("DROP TABLE users"); // Это вызовет исключение
} catch (RuntimeException $e) {
    echo "Ошибка подключения: " . $e->getMessage();
} catch (Exception $e) {
    echo "Ошибка запроса: " . $e->getMessage();
} finally {
    $db->disconnect();
    echo "Соединение закрыто";
}

Пример 6: Собственное исключение для валидации формы

// Создаём своё исключение для валидации
class ValidationException extends Exception {
    private $fieldName;
    private $errorType;
    
    public function __construct($fieldName, $errorType, $message) {
        parent::__construct($message);
        $this->fieldName = $fieldName;
        $this->errorType = $errorType;
    }
    
    public function getFieldName() {
        return $this->fieldName;
    }
    
    public function getErrorType() {
        return $this->errorType;
    }
}

// Функция валидации формы регистрации
function validateRegistrationForm($data) {
    // Проверяем имя
    if (empty($data['name'])) {
        throw new ValidationException('name', 'empty', 'Имя не может быть пустым');
    }
    if (strlen($data['name']) < 2) {
        throw new ValidationException('name', 'too_short', 'Имя должно быть длиннее 2 символов');
    }
    
    // Проверяем email
    if (empty($data['email'])) {
        throw new ValidationException('email', 'empty', 'Email не может быть пустым');
    }
    if (!filter_var($data['email'], FILTER_VALIDATE_EMAIL)) {
        throw new ValidationException('email', 'invalid', 'Некорректный формат email');
    }
    
    // Проверяем пароль
    if (empty($data['password'])) {
        throw new ValidationException('password', 'empty', 'Пароль не может быть пустым');
    }
    if (strlen($data['password']) < 6) {
        throw new ValidationException('password', 'too_short', 'Пароль должен быть длиннее 6 символов');
    }
    
    return true;
}

// Тестируем
$formData = [
    'name' => 'А',
    'email' => 'неправильный_email',
    'password' => '123'
];

try {
    validateRegistrationForm($formData);
    echo "Форма прошла валидацию";
} catch (ValidationException $e) {
    echo "Ошибка в поле '" . $e->getFieldName() . "': " . $e->getMessage();
    echo " (тип ошибки: " . $e->getErrorType() . ")";
}

Пример 7: Цепочка исключений (Exception Chaining)

// Иногда одно исключение порождает другое
class FileProcessingException extends Exception {
    public function __construct($message, $code = 0, Throwable $previous = null) {
        parent::__construct($message, $code, $previous);
    }
}

function processFile($filename) {
    try {
        // Пытаемся открыть файл
        if (!file_exists($filename)) {
            throw new Exception("Файл не найден: $filename");
        }
        
        // Обрабатываем файл...
        $content = file_get_contents($filename);
        
    } catch (Exception $e) {
        // Оборачиваем исключение в более высокоуровневое
        throw new FileProcessingException(
            "Не удалось обработать файл",
            0,
            $e  // Передаём предыдущее исключение
        );
    }
}

try {
    processFile("несуществующий_файл.txt");
} catch (FileProcessingException $e) {
    echo "Ошибка обработки: " . $e->getMessage() . "
";
    echo "Предыдущая ошибка: " . $e->getPrevious()->getMessage();
}

Сравнение с Python: чем похоже и чем отличается

Если ты уже знаком с Python, тебе будет проще понять PHP. Но есть важные различия.

Характеристика PHP Python
Ключевые слова try, catch, finally, throw try, except, finally, raise
Типизация исключений Строгая: нужно указывать тип исключения в catch Можно ловить несколько типов в одном except
Базовый класс Exception (для пользовательских) и Error (для системных) BaseException (все), Exception (пользовательские)
Создание исключения throw new Exception("сообщение") raise Exception("сообщение")
Получение сообщения $e->getMessage() str(e)
Цепочка исключений Через третий параметр конструктора Через raise ... from ...
Блок else Нет Есть (выполняется, если не было исключения)
Глобальный обработчик set_exception_handler() sys.excepthook

Главное отличие — в Python блок else выполняется, если исключения не было. В PHP такого нет, но можно эмулировать с помощью флага.

// Эмуляция else в PHP
$success = false;
try {
    // Код, который может выбросить исключение
    $result = 10 / 2;
    $success = true;
} catch (DivisionByZeroError $e) {
    echo "Ошибка";
}

if ($success) {
    echo "Всё хорошо, результат: $result";
}

Типичные ошибки и подводные камни

Даже опытные программисты иногда спотыкаются на исключениях. Вот самые частые грабли.

1. Слишком общий catch

Ловить Exception везде — плохая практика. Ты можешь случайно проглотить серьёзную ошибку.

// ПЛОХО: ловим всё подряд
try {
    // Какой-то код
} catch (Exception $e) {
    // Мы не знаем, что случилось
    echo "Что-то пошло не так";
}

// ХОРОШО: ловим конкретные исключения
try {
    // Какой-то код
} catch (InvalidArgumentException $e) {
    echo "Неверные аргументы";
} catch (RuntimeException $e) {
    echo "Ошибка выполнения";
}

2. Пустой блок catch

Никогда не оставляй блок catch пустым. Это как пожарная сигнализация, которая просто отключается без оповещения.

// ПЛОХО: проглатываем ошибку
try {
    // Код
} catch (Exception $e) {
    // Ничего не делаем — ошибка исчезла бесследно
}

// ХОРОШО: хотя бы логируем
try {
    // Код
} catch (Exception $e) {
    error_log("Ошибка: " . $e->getMessage());
    // Или показываем пользователю общее сообщение
    echo "Произошла ошибка, мы уже работаем над ней";
}

3. Исключения в деструкторах

В PHP нельзя выбрасывать исключения из деструкторов классов. Это приведёт к фатальной ошибке.

class BadClass {
    public function __destruct() {
        // ПЛОХО: исключение в деструкторе
        throw new Exception("Ошибка в деструкторе");
    }
}

4. Забыли про finally

Если ты открываешь ресурсы (файлы, соединения с БД), всегда используй finally для их закрытия. Иначе при исключении ресурсы останутся висеть в памяти.

// ПЛОХО: ресурс не закроется при исключении
$file = fopen("test.txt", "r");
// Если здесь произойдёт исключение, файл останется открытым
$content = fread($file, 100);
fclose($file);

// ХОРОШО: ресурс закроется в любом случае
$file = fopen("test.txt", "r");
try {
    $content = fread($file, 100);
} finally {
    fclose($file);
}

5. Путаница между ошибками и исключениями

Помни: не все ошибки PHP — это исключения. Старые функции могут выдавать Warning, а не исключение. Используй set_error_handler(), чтобы превратить их в исключения.

6. Слишком много вложенных try-catch

Не делай «матрешку» из try-catch. Это делает код нечитаемым. Лучше вынеси логику в отдельные функции.

// ПЛОХО: матрёшка
try {
    try {
        try {
            // Код
        } catch (Exception $e) {
            // ...
        }
    } catch (Exception $e) {
        // ...
    }
} catch (Exception $e) {
    // ...
}

// ХОРОШО: выносим в функции
function firstLevel() {
    try {
        secondLevel();
    } catch (Exception $e) {
        // ...
    }
}

function secondLevel() {
    try {
        thirdLevel();
    } catch (Exception $e) {
        // ...
    }
}

Лучшие практики и советы профессионалов

Вот что советуют опытные PHP-разработчики. Запомни эти правила — они сэкономят тебе много нервов.

1. Исключения — для исключительных ситуаций

Не используй исключения для управления потоком программы. Это не goto. Исключение — это действительно что-то неожиданное и редкое.

// ПЛОХО: исключение как условие
try {
    if ($user->isBlocked()) {
        throw new Exception("Пользователь заблокирован");
    }
    // Дальнейший код
} catch (Exception $e) {
    echo "Доступ запрещён";
}

// ХОРОШО: обычное условие
if ($user->isBlocked()) {
    echo "Доступ запрещён";
} else {
    // Дальнейший код
}

2. Создавай свои классы исключений

Для больших проектов создавай иерархию своих исключений. Это упрощает отладку и делает код понятнее.

// Базовая структура исключений для приложения
namespace AppExceptions;

class AppException extends Exception {}
class DatabaseException extends AppException {}
class ValidationException extends AppException {}
class AuthException extends AppException {}
class NotFoundException extends AppException {}

3. Логируй все исключения

Даже если ты показываешь пользователю общее сообщение, обязательно записывай полную информацию об ошибке в лог.

try {
    // Код
} catch (Exception $e) {
    // Логируем для разработчиков
    error_log("[" . date('Y-m-d H:i:s') . "] " . $e->__toString());
    
    // Пользователю показываем общее сообщение
    echo "Извините, произошла ошибка. Мы уже знаем о ней и работаем над исправлением.";
}

4. Используй HTTP-коды ошибок

Если ты пишешь API, возвращай правильные HTTP-статусы вместе с исключениями.

class HttpException extends Exception {
    private $statusCode;
    
    public function __construct($message, $statusCode = 500) {
        parent::__construct($message);
        $this->statusCode = $statusCode;
    }
    
    public function getStatusCode() {
        return $this->statusCode;
    }
}

// В обработчике
try {
    // Код API
} catch (HttpException $e) {
    http_response_code($e->getStatusCode());
    echo json_encode(['error' => $e->getMessage()]);
}

5. Не бойся выбрасывать исключения рано

Принцип «Fail Fast» — если что-то не так, лучше сразу выбросить исключение, чем пытаться работать с некорректными данными.

function processOrder($orderData) {
    // Проверяем всё в начале
    if (empty($orderData['items'])) {
        throw new ValidationException("Заказ пуст");
    }
    if (empty($orderData['user_id'])) {
        throw new ValidationException("Пользователь не указан");
    }
    if (empty($orderData['address'])) {
        throw new ValidationException("Адрес не указан");
    }
    
    // Только после всех проверок начинаем обработку
    // ...
}

6. Документируй исключения

В PHPDoc указывай, какие исключения может выбрасывать функция. Это помогает другим разработчикам.

/**
 * Сохраняет пользователя в базу данных
 *
 * @param array $userData Данные пользователя
 * @return int ID сохранённого пользователя
 * @throws ValidationException Если данные некорректны
 * @throws DatabaseException Если ошибка базы данных
 */
function saveUser(array $userData): int {
    // ...
}

Вопросы для самопроверки

Проверь себя: ответь на вопросы, а потом сверься с ответами.

  1. Вопрос: Что такое исключение в PHP?
    Ответ: Это объект, который сигнализирует о возникновении ошибки или нештатной ситуации. Он содержит информацию о проблеме: сообщение, код, файл и строку.
  2. Вопрос: Какие три ключевых слова используются для обработки исключений?
    Ответ: try (попробовать выполнить код), catch (поймать исключение), finally (выполнить в любом случае).
  3. Вопрос: В чём разница между Exception и Error в PHP 7+?
    Ответ: Exception — для пользовательских исключений, Error — для системных ошибок (например, нехватка памяти). Оба реализуют интерфейс Throwable.
  4. Вопрос: Можно ли иметь несколько блоков catch для одного try?
    Ответ: Да, можно. Важно располагать их от более конкретных к более общим.
  5. Вопрос: Что произойдёт, если исключение не будет поймано?
    Ответ: PHP вызовет глобальный обработчик (если он установлен) или выдаст фатальную ошибку и остановит скрипт.
  6. Вопрос: Как создать своё собственное исключение?
    Ответ: Нужно создать класс, который наследует от Exception (или другого класса исключений) и переопределить конструктор при необходимости.
  7. Вопрос: Для чего нужен блок finally?
    Ответ: Для выполнения кода, который должен быть выполнен в любом случае: закрытие файлов, освобождение ресурсов, закрытие соединений.
  8. Вопрос: Чем отличается set_exception_handler от set_error_handler?
    Ответ: set_exception_handler обрабатывает неп
← Vorherige OOP: Kapselung und Polymorphie in PHP: Eine ausfüh Weiter → Dateiarbeit in PHP: Eine ausführliche Anleitung