Обработка пользовательских ошибок при разработке на PHP

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

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

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

<?php
// Настройка обработчика
function customErrorHandler($errno, $errstr, $errfile, $errline) {
    $levels = [
        E_USER_ERROR      => 'Ошибка',
        E_USER_WARNING    => 'Предупреждение',
        E_USER_NOTICE     => 'Уведомление',
    ];
    $levelName = $levels[$errno] ?? 'Неизвестный уровень';
    $logEntry = sprintf("[%s] %s в %s:%d", $levelName, $errstr, $errfile, $errline);
    error_log($logEntry, 3, __DIR__ . '/../logs/user_errors.log');
    
    // Для тяжёлых ошибок отправка email администратору
    if ($errno == E_USER_ERROR) {
        mail('admin@example.com', 'Критическая ошибка пользователя', $logEntry);
        echo "<div class='alert alert-danger'>Критическая ошибка. Обратитесь к администратору.</div>";
        exit(1);
    }
    return true;
}
set_error_handler('customErrorHandler');

// Вызовы разных уровней
trigger_error("Неверный формат email", E_USER_NOTICE);
trigger_error("Попытка входа с заблокированного IP", E_USER_WARNING);
trigger_error("SQL-инъекция в поле username", E_USER_ERROR);

echo "Этот текст не будет выведен при E_USER_ERROR";
?>

(Вывод на экран при E_USER_ERROR)
<div class='alert alert-danger'>Критическая ошибка. Обратитесь к администратору.</div>
(В лог файл user_errors.log добавятся три строки)
[Уведомление] Неверный формат email в /var/www/script.php:17
[Предупреждение] Попытка входа с заблокированного IP в /var/www/script.php:18
[Ошибка] SQL-инъекция в поле username в /var/www/script.php:19

Пример 2. Преобразование ошибок в исключения и фильтрация по уровню

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

<?php
function selectiveExceptionHandler($severity, $message, $file, $line) {
    // Превращаем только E_USER_ERROR в исключение
    if ($severity === E_USER_ERROR) {
        throw new ErrorException($message, 0, $severity, $file, $line);
    }
    // Для E_USER_WARNING и E_USER_NOTICE просто логируем
    $log = sprintf("[%s] %s в %s:%d",
        ($severity === E_USER_WARNING ? 'WARNING' : 'NOTICE'),
        $message, $file, $line
    );
    error_log($log);
    return true;
}
set_error_handler('selectiveExceptionHandler');

try {
    trigger_error("Попытка доступа без авторизации", E_USER_ERROR);
} catch (ErrorException $e) {
    echo "Исключение: " . $e->getMessage();
    // Дополнительно записать в отдельный лог
    file_put_contents('access_errors.log', $e->getMessage() . PHP_EOL, FILE_APPEND);
}

trigger_error("Истекло время сессии", E_USER_NOTICE);
echo "Скрипт завершился";
?>

Исключение: Попытка доступа без авторизации
(в стандартный лог ошибок добавлена запись для NOTICE)
Скрипт завершился

Пример 3. Использование пользовательского класса ошибок с контекстом

Создаётся класс, который хранит дополнительную информацию о пользователе и времени.

<?php
class UserError extends Exception {
    private $userId;
    private $ip;
    private $timestamp;

    public function __construct($message, $userId = null, $ip = null) {
        parent::__construct($message);
        $this->userId = $userId;
        $this->ip = $ip ?? $_SERVER['REMOTE_ADDR'] ?? 'unknown';
        $this->timestamp = date('Y-m-d H:i:s');
    }

    public function getContext() {
        return [
            'user_id'  => $this->userId,
            'ip'       => $this->ip,
            'time'     => $this->timestamp,
            'message'  => $this->getMessage()
        ];
    }
}

function loginUser($username, $password) {
    // ... проверка
    if (!$password) {
        throw new UserError("Пустой пароль", null, $_SERVER['REMOTE_ADDR']);
    }
    // Ещё проверка
}

try {
    loginUser('user', '');
} catch (UserError $e) {
    $context = $e->getContext();
    $logLine = json_encode($context) . PHP_EOL;
    file_put_contents('user_errors.json', $logLine, FILE_APPEND);
    echo "Ошибка: " . $e->getMessage() . " (IP: " . $context['ip'] . ")";
}
?>

Ошибка: Пустой пароль (IP: 192.168.1.100)
(в файл user_errors.json добавлена строка)
{"user_id":null,"ip":"192.168.1.100","time":"2025-04-07 14:32:00","message":"Пустой пароль"}

Пример 4. Работа с E_USER_DEPRECATED и обратной совместимостью

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

<?php
error_reporting(E_ALL);

function oldUserFunction() {
    trigger_error("Функция oldUserFunction устарела, используйте newUserFunction", E_USER_DEPRECATED);
    // старый код
}

set_error_handler(function($errno, $errstr) {
    if ($errno === E_USER_DEPRECATED) {
        error_log("[DEPRECATED] " . $errstr);
    }
    return true;
});

oldUserFunction();
echo "Вызов устаревшей функции не прерывает выполнение";
?>

Вызов устаревшей функции не прерывает выполнение
(в лог ошибок добавлена запись о deprecated)