Настройка собственного обработчика ошибок в PHP

Развёрнутые примеры использования обработчика ошибок

Пример 1: Обработка различных уровней ошибок с логированием в файл

// Файл: error_handler.php
function universalHandler($severity, $message, $file, $line) {
    $levelNames = [
        E_WARNING => 'Warning',
        E_NOTICE  => 'Notice',
        E_USER_WARNING => 'User Warning',
        E_USER_NOTICE  => 'User Notice',
        E_STRICT  => 'Strict',
        E_DEPRECATED => 'Deprecated',
    ];
    $levelName = $levelNames[$severity] ?? 'Unknown';

    $entry = sprintf(
        "[%s] %s: %s in %s:%d\n",
        date('Y-m-d H:i:s'),
        $levelName,
        $message,
        $file,
        $line
    );
    file_put_contents('site_errors.log', $entry, FILE_APPEND);

    // Не прерываем выполнение для Notices и Warnings
    if ($severity === E_WARNING || $severity === E_USER_WARNING) {
        // Можно показать сообщение пользователю
        echo "Возникла проблема, запись добавлена в лог.";
    }
    return true;
}

set_error_handler('universalHandler');

// Вызовы:
trigger_error('Тестовое уведомление', E_USER_NOTICE);
trigger_error('Тестовое предупреждение', E_USER_WARNING);
$a = 1 / 0; // Division by zero (E_WARNING)

(Файл site_errors.log):
[2025-04-15 10:00:00] User Notice: Тестовое уведомление in /path/to/test.php:12
[2025-04-15 10:00:01] User Warning: Тестовое предупреждение in /path/to/test.php:13
[2025-04-15 10:00:01] Warning: Division by zero in /path/to/test.php:14

Пример 2: Класс-обработчик с гибкими настройками

class ErrorHandler {
    private $logDir;
    private $displayErrors;

    public function __construct($logDir = '/tmp', $displayErrors = false) {
        $this->logDir = rtrim($logDir, '/');
        $this->displayErrors = $displayErrors;
    }

    public function handle($severity, $message, $file, $line) {
        $this->writeLog($severity, $message, $file, $line);
        if ($this->displayErrors && (error_reporting() & $severity)) {
            echo "Ошибка: " . htmlspecialchars($message);
        }
        // Не блокируем выполнение
        return true;
    }

    private function writeLog($severity, $message, $file, $line) {
        $logFile = $this->logDir . '/php_errors.log';
        $entry = sprintf("[%s] [%d] %s: %s\n", date('c'), $severity, basename($file) . ':' . $line, $message);
        file_put_contents($logFile, $entry, FILE_APPEND);
    }
}

$handler = new ErrorHandler(__DIR__ . '/logs', true);
set_error_handler([$handler, 'handle']);

// Проверка
file_get_contents('/nonexistent'); // Warning

Вывод на экране: Ошибка: file_get_contents(/nonexistent): Failed to open stream: No such file or directory
(в логе аналогичная запись)

Пример 3: Преобразование ошибок в исключения с восстановлением после try-catch

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

function riskyOperation($value) {
    // Предположим, что $value может быть нечисловым
    return 100 / $value;
}

try {
    $result = riskyOperation(0);
    echo "Результат: $result";
} catch (ErrorException $e) {
    echo "Поймана ошибка: " . $e->getMessage() . " (код: " . $e->getCode() . ")";
    // Действия по восстановлению
    $result = 0;
}

echo "\nПродолжение выполнения...";

Поймана ошибка: Division by zero (код: 2)
Продолжение выполнения...

Пример 4: Обработка фатальных ошибок с помощью shutdown-функции

register_shutdown_function(function() {
    $error = error_get_last();
    if ($error && ($error['type'] & (E_ERROR | E_PARSE | E_CORE_ERROR | E_COMPILE_ERROR))) {
        echo "Критическая ошибка: " . $error['message'] . " в файле " . $error['file'] . " на строке " . $error['line'];
        // Здесь можно отправить email разработчику или записать в лог
        error_log("FATAL: " . json_encode($error));
    }
});

// Вызов несуществующего класса - E_ERROR
// $obj = new NonExistentClass();

Критическая ошибка: Class "NonExistentClass" not found в файле /path/to/test.php на строке 10
(В логе ошибок аналогичная запись)

Пример 5: Влияние оператора подавления ошибок (@) на обработчик

set_error_handler(function($severity, $message) {
    echo "Обработчик вызван для: $message\n";
    return true;
});

// Без @
file_get_contents('/missing'); // Warning, обработчик сработает

// С @
@file_get_contents('/missing'); // Warning скрыто, обработчик НЕ будет вызван

Обработчик вызван для: file_get_contents(/missing): Failed to open stream: No such file or directory
(второй раз сообщение не выводится)

Это происходит потому, что оператор @ временно устанавливает error_reporting(0). Чтобы обработчик всё равно вызывался, внутри него можно проверить значение error_reporting() и, если оно равно 0, самостоятельно решить, обрабатывать ли ошибку.