Стандартная ошибка PHP: настройка обработки и примеры

Расширенные примеры обработки ошибок PHP

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

Логирование ошибок в базу данных

Пример пользовательского обработчика, который сохраняет ошибку в таблицу MySQL:

function dbErrorHandler($severity, $message, $file, $line) {
    $pdo = new PDO('mysql:host=localhost;dbname=errors', 'user', 'pass');
    $stmt = $pdo->prepare('INSERT INTO error_log (severity, message, file, line, time) VALUES (?, ?, ?, ?, NOW())');
    $stmt->execute([$severity, $message, $file, $line]);
    // Продолжить стандартную обработку
    return false;
}
set_error_handler('dbErrorHandler');

// Пример вызова
$undefined = $someVar; // Notice: Undefined variable

Результат (в БД появится запись):

+----------+----------------------------+---------------+------+---------------------+
| severity | message                    | file          | line | time                |
+----------+----------------------------+---------------+------+---------------------+
| 8        | Undefined variable: someVar| /var/www/...  | 10   | 2025-03-25 12:00:00 |
+----------+----------------------------+---------------+------+---------------------+

Перехват фатальных ошибок через register_shutdown_function

Обработчик set_error_handler() не ловит E_ERROR. Для этого используется завершающая функция:

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(sprintf(
            'FATAL: %s in %s on line %d',
            $error['message'],
            $error['file'],
            $error['line']
        ));
        // Можно вывести дружественное сообщение
        echo 'Произошла критическая ошибка. Мы уже работаем над ней.';
    }
});

// Пример вызова фатальной ошибки
undefinedFunction(); // Call to undefined function

Результат в лог-файле:

[25-Mar-2025 12:00:00 UTC] FATAL: Call to undefined function undefinedFunction() in /var/www/index.php on line 10

Отправка ошибок на email

Пользовательский обработчик с отправкой письма администратору:

function emailErrorHandler($severity, $message, $file, $line) {
    $to = 'admin@example.com';
    $subject = 'PHP Error on ' . $_SERVER['HTTP_HOST'];
    $body = "Severity: $severity\nMessage: $message\nFile: $file\nLine: $line\nURL: " . ($_SERVER['REQUEST_URI'] ?? 'CLI');
    mail($to, $subject, $body, 'From: errors@example.com');
    return true;
}
set_error_handler('emailErrorHandler');

trigger_error('Тестовое предупреждение', E_USER_WARNING);

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

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

Пример, который обрабатывает ошибки по-разному в зависимости от severity:

function smartErrorHandler($severity, $message, $file, $line) {
    // Пропускаем ошибки, отключённые через error_reporting
    if (!(error_reporting() & $severity)) return false;

    switch ($severity) {
        case E_NOTICE:
        case E_USER_NOTICE:
            // Просто логируем
            error_log("Notice: $message in $file:$line");
            break;
        case E_WARNING:
        case E_USER_WARNING:
            // Логируем и отправляем email
            error_log("Warning: $message in $file:$line");
            mail('dev@example.com', 'PHP Warning', "$message in $file:$line");
            break;
        case E_ERROR:
        case E_USER_ERROR:
            // Для фатальных - выводим страницу ошибки и прекращаем работу
            ob_clean();
            http_response_code(500);
            include 'error500.html';
            exit(1);
        default:
            error_log("Unknown error: $message in $file:$line");
    }
    return true;
}
set_error_handler('smartErrorHandler');

Восстановление предыдущего обработчика

Если требуется временно изменить обработчик и вернуть старый:

$oldHandler = set_error_handler(function($severity, $message, $file, $line) {
    echo 'Временный обработчик: ' . $message;
    return true;
});

// Код, где нужна особая обработка
trigger_error('Временная ошибка', E_USER_NOTICE);

// Восстановление
restore_error_handler();

// Проверка, что старый обработчик работает
trigger_error('Обычная ошибка', E_USER_NOTICE);

Результат выполнения:

Временный обработчик: Временная ошибка
Обычная ошибка (если старый обработчик был установлен, будет его результат)

Использование error_get_last() для диагностики после failed операций

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

@file_get_contents('http://несуществующий-сайт.ру');
$lastError = error_get_last();
if ($lastError !== null) {
    echo 'Последняя ошибка: ' . $lastError['message'];
} else {
    echo 'Ошибок нет';
}

Результат:

Последняя ошибка: file_get_contents(http://несуществующий-сайт.ру): failed to open stream: php_network_getaddresses: getaddrinfo for несуществующий-сайт.ру failed: Name or service not known