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

Расширенный пример 1: Полноценный класс обработки ошибок

Создадим класс ErrorHandler, который объединяет все механизмы: обработка ошибок, исключений, фатальных ошибок. Класс позволяет гибко настраивать вывод и логирование.

class ErrorHandler {
    protected $logFile;
    protected $displayErrors;
    public function __construct($logFile, $displayErrors = false) {
        $this->logFile = $logFile;
        $this->displayErrors = $displayErrors;
        $this->registerHandlers();
    }
    protected function registerHandlers() {
        set_error_handler([$this, 'handleError']);
        set_exception_handler([$this, 'handleException']);
        register_shutdown_function([$this, 'handleShutdown']);
    }
    public function handleError($severity, $message, $file, $line) {
        if (error_reporting() === 0) return false;
        $this->log('Error', $severity, $message, $file, $line);
        if ($this->displayErrors) {
            echo 'PHP Error [' . $severity . ']: ' . $message . ' in ' . $file . ':' . $line . "\n";
        }
        return true;
    }
    public function handleException($exception) {
        $this->log('Exception', $exception->getCode(), $exception->getMessage(), $exception->getFile(), $exception->getLine());
        if ($this->displayErrors) {
            echo 'Uncaught Exception: ' . $exception->getMessage() . "\n";
        }
    }
    public function handleShutdown() {
        $error = error_get_last();
        if ($error && in_array($error['type'], [E_ERROR, E_PARSE, E_CORE_ERROR, E_COMPILE_ERROR])) {
            $this->log('Fatal', $error['type'], $error['message'], $error['file'], $error['line']);
            if ($this->displayErrors) {
                echo 'Fatal Error: ' . $error['message'] . "\n";
            }
        }
    }
    protected function log($type, $code, $message, $file, $line) {
        $entry = date('Y-m-d H:i:s') . " [$type] Code $code: $message in $file:$line" . PHP_EOL;
        file_put_contents($this->logFile, $entry, FILE_APPEND | LOCK_EX);
    }
}
// Использование
$handler = new ErrorHandler(__DIR__ . '/logs/app.log', true);
// Пример ошибки
echo $undefinedVariable;

Результат выполнения: В лог-файл будет записана запись об уведомлении, а на экране появится сообщение (если displayErrors = true). Кроме того, класс защищён от повторного вызова лога при подавлении ошибки.

PHP Error [8]: Undefined variable: undefinedVariable in /path/to/test.php:40

Расширенный пример 2: Красивая страница ошибки для продакшена

Вместо стандартного сообщения можно показывать пользователю дружественную HTML-страницу, а разработчику отправлять email с деталями. Используем обработчик исключений.

function productionExceptionHandler($exception) {
    // Логируем в файл
    error_log(date('Y-m-d H:i:s') . " [CRITICAL] {$exception->getMessage()} in {$exception->getFile()}:{$exception->getLine()}\n", 3, '/var/log/prod_errors.log');
    // Отправляем email администратору
    $subject = 'Критическая ошибка на сайте';
    $body = "Ошибка: {$exception->getMessage()}\nФайл: {$exception->getFile()}:{$exception->getLine()}\nТрассировка:\n{$exception->getTraceAsString()}";
    mail('admin@example.com', $subject, $body);
    // Показываем красивую страницу
    http_response_code(500);
    echo file_get_contents('error500.html');
    exit;
}
set_exception_handler('productionExceptionHandler');

Результат: Пользователь видит статичную страницу error500.html, администратор получает письмо, а в лог записываются детали. При этом скрипт завершается корректно.

Расширенный пример 3: Преобразование всех ошибок в исключения с помощью ErrorException

Этот подход удобен при работе с современными фреймворками и PSR-3 логгерами. Все стандартные ошибки становятся исключениями, которые можно ловить в try-catch.

set_error_handler(function($severity, $message, $file, $line) {
    // Исключение для всех уровней, кроме тех, что подавлены
    if (error_reporting() & $severity) {
        throw new \ErrorException($message, 0, $severity, $file, $line);
    }
});
try {
    // Код с предупреждением
    $result = 1 / 0; // Division by zero (E_WARNING)
} catch (\ErrorException $e) {
    echo 'Поймано ErrorException: ' . $e->getMessage() . ' (код: ' . $e->getSeverity() . ')';
}

Результат: Выведется сообщение: "Поймано ErrorException: Division by zero (код: 2)". Такой подход упрощает унификацию обработки ошибок и исключений.

Поймано ErrorException: Division by zero (код: 2)

Расширенный пример 4: Использование syslog для централизованного логирования

Если требуется запись ошибок в системный журнал (syslog), можно использовать функцию openlog() и syslog().

openlog('MyApp', LOG_PID | LOG_PERROR, LOG_LOCAL0);
set_error_handler(function($severity, $message, $file, $line) {
    $priority = LOG_ERR; // по умолчанию
    if ($severity === E_WARNING || $severity === E_USER_WARNING) $priority = LOG_WARNING;
    elseif ($severity === E_NOTICE || $severity === E_USER_NOTICE) $priority = LOG_NOTICE;
    syslog($priority, "Error in $file:$line: $message");
    return true;
});
// Пример
trigger_error('User notice', E_USER_NOTICE);
closelog();

Результат: В системном логе (например, /var/log/syslog) появится запись вида: "May 20 12:34:56 hostname MyApp[12345]: Error in /path/to/file.php:10: User notice". Преимущество - централизованный сбор логов, удобно на серверах.