Обработка фатальных ошибок PHP: как избежать краха приложения

// Глобальный обработчик неперехваченных исключений (включая Error)
set_exception_handler(function($exception) {
    // Логирование в файл
    error_log("Необработанное исключение: " . $exception->getMessage() . " в " . $exception->getFile() . ":" . $exception->getLine());
    // Отображение пользователю (в production лучше скрыть)
    if (ini_get('display_errors')) {
        echo "Произошла критическая ошибка. Пожалуйста, попробуйте позже.";
    }
});

// Пример кода с потенциальной ошибкой
function divide($a, $b) {
    if ($b === 0) {
        throw new \DivisionByZeroError('Деление на ноль');
    }
    return $a / $b;
}

try {
    echo divide(10, 0);
} catch (\DivisionByZeroError $e) {
    echo 'Обработано локально: ' . $e->getMessage();
}
  

Вариант 1. Как перехватить конкретный тип ошибки (например, TypeError или ValueError)?

Используется блок try-catch с указанием класса ошибки. Позволяет обрабатывать только определённые ситуации, не затрагивая другие исключения.

try {
    // Функция ожидает int, но получает string
    $result = array_sum(['a', 'b']); // TypeError
} catch (\TypeError $e) {
    echo 'Тип данных неверен: ' . $e->getMessage();
}
  

Цель: точная реакция на определённые типы фатальных ошибок (неверный тип, деление на ноль, переполнение). Используется в библиотеках и компонентах, где известны возможные сценарии сбоев.

Вариант 2. Как использовать глобальный обработчик для всех неперехваченных исключений (включая Error)?

Функция set_exception_handler перехватывает любые исключения, не пойманные в try-catch. Для ошибок класса Error это единственный способ предотвратить фатальное завершение.

set_exception_handler(function($e) {
    // Логирование в системный лог
    error_log($e);
    // Вывод страницы с ошибкой
    http_response_code(500);
    include 'error_page.php';
});

// Пример: вызов несуществующего метода
$obj = new stdClass();
$obj->nonExistentMethod(); // Error: Call to undefined method
  

Цель: единая точка входа для логирования и отображения ошибок в production. Случаи использования: фреймворки, CMS, где нужно стандартизировать вывод ошибок.

Вариант 3. Как преобразовывать фатальные ошибки в исключения с помощью set_error_handler?

Для нефатальных ошибок (Notice, Warning) set_error_handler позволяет выбросить ErrorException. Однако класс Error (фатальные) не проходит через этот обработчик - для них нужен отдельный механизм (например, register_shutdown_function).

set_error_handler(function($severity, $message, $file, $line) {
    if (!(error_reporting() & $severity)) {
        // Ошибка подавлена оператором @
        return false;
    }
    throw new \ErrorException($message, 0, $severity, $file, $line);
});

// Пример: Warning от file_get_contents
set_error_handler(null); // Временно отключаем для примера
  

Цель: унифицировать обработку всех ошибок как исключений (для Warning, Notice). Не подходит для фатальных Error, но полезно в комбинации с другими методами.

Вариант 4. Как логировать фатальные ошибки с register_shutdown_function?

Функция регистрируется для выполнения при завершении скрипта. Позволяет перехватить последнюю ошибку (включая фатальные) с помощью error_get_last().

register_shutdown_function(function() {
    $error = error_get_last();
    if ($error !== null && in_array($error['type'], [E_ERROR, E_PARSE, E_CORE_ERROR, E_COMPILE_ERROR])) {
        // Логируем фатальную ошибку
        error_log("Фатальная ошибка: {$error['message']} в {$error['file']}:{$error['line']}");
        // Отправляем уведомление администратору
        mail('admin@example.com', 'Фатальная ошибка', print_r($error, true));
    }
});
  

Цель: гарантированное логирование любых фатальных ошибок, даже тех, которые не были перехвачены try-catch. Используется как дополнение к основному обработчику.

Вариант 5. Как настроить отображение ошибок через php.ini для отладки?

Параметры display_errors, error_reporting и log_errors управляют выводом и записью ошибок. Для фатальных Error это даёт полную информацию на этапе разработки.

; php.ini (development)
display_errors = On
error_reporting = E_ALL
log_errors = On
error_log = /var/log/php_errors.log
  

Цель: быстрая отладка в разработке и централизованное логирование в production. Не является методом обработки, но обязательная часть инфраструктуры.

Вариант 6. Как использовать Xdebug для трассировки фатальных ошибок?

Xdebug улучшает сообщения об ошибках, добавляет стек вызовов, показывает значения переменных. Для фатальных Error можно получить полную трассу.

; php.ini с Xdebug
zend_extension=xdebug.so
xdebug.mode=develop
xdebug.collect_params=4
  

Цель: глубокая отладка во время разработки, особенно для сложных ошибок, где нужно видеть цепочку вызовов.