Как генерировать и контролировать PHP-предупреждения

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

В этом примере создаётся собственный класс исключения, который хранит уровень ошибки и дополнительные данные. Обработчик выбрасывает такое исключение, а catch анализирует severity.

<?php
class WarningException extends \Exception {
    protected $severity;
    
    public function __construct($message, $severity, $code = 0, \Throwable $previous = null) {
        $this->severity = $severity;
        parent::__construct($message, $code, $previous);
    }
    
    public function getSeverity() {
        return $this->severity;
    }
}

set_error_handler(function($severity, $message, $file, $line) {
    // Пропускаем уведомления (E_NOTICE, E_USER_NOTICE)
    if (in_array($severity, [E_WARNING, E_USER_WARNING, E_CORE_WARNING, E_COMPILE_WARNING])) {
        throw new WarningException($message, $severity, 0);
    }
    return false; // прочие ошибки обрабатываются стандартно
});

try {
    $result = 1 / 0;
} catch (WarningException $e) {
    echo 'Поймано предупреждение уровня ' . $e->getSeverity() . ': ' . $e->getMessage();
}
?>
  

Поймано предупреждение уровня 2: Division by zero
  

Таким образом можно гибко фильтровать разные типы предупреждений и обрабатывать их отдельно.

Выброс предупреждения внутри класса и его перехват с помощью try-catch

Показывает, как объектно-ориентированный код использует trigger_error, а внешний обработчик превращает его в исключение.

<?php
set_error_handler(function($severity, $message) {
    throw new ErrorException($message, 0, $severity);
});

class Calculator {
    public function divide($a, $b) {
        if ($b == 0) {
            trigger_error('Деление на ноль', E_USER_WARNING);
            return null;
        }
        return $a / $b;
    }
}

$calc = new Calculator();
try {
    $result = $calc->divide(5, 0);
} catch (ErrorException $e) {
    echo 'Ошибка в калькуляторе: ' . $e->getMessage();
}
?>
  

Ошибка в калькуляторе: Деление на ноль
  

Использование error_get_last после подавления предупреждения

Иногда удобно подавить предупреждение оператором @, а затем получить его информацию через error_get_last(). Это альтернатива обработчику.

<?php
@file_get_contents('missing.txt');
$error = error_get_last();
if ($error !== null && $error['type'] === E_WARNING) {
    echo 'Было подавлено предупреждение: ' . $error['message'];
    // Сброс, чтобы не влиять на последующие проверки
    error_clear_last();
}
?>
  

Было подавлено предупреждение: file_get_contents(missing.txt): Failed to open stream: No such file or directory
  

Подходит для одноразовых вызовов без установки глобального обработчика.

Фильтрация предупреждений по категориям с помощью битовых масок

При использовании set_error_handler можно проверять severity с помощью побитовых операций, чтобы обрабатывать только определённые типы.

<?php
set_error_handler(function($severity, $message, $file, $line) {
    // Обрабатываем только E_USER_WARNING и E_WARNING
    if ($severity & (E_WARNING | E_USER_WARNING)) {
        throw new ErrorException($message, 0, $severity, $file, $line);
    }
    // Возвращаем false для остальных (они пойдут в стандартный обработчик)
    return false;
});

trigger_error('Это будет перехвачено', E_USER_WARNING);
trigger_error('Это уведомление не перехватывается', E_USER_NOTICE); // пропустится
echo 'Конец';
?>
  

PHP Notice:  Это уведомление не перехватывается in ...
Конец
  

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