Техники трассировки фатальных сбоев в PHP7: от перехвата до логирования

<?php
// Полный обработчик ошибок для production
class ErrorHandler {
    private static $logFile = '/var/log/php_errors.log';
    private static $email = 'admin@example.com';

    public static function register() {
        set_exception_handler([self::class, 'handleException']);
        set_error_handler([self::class, 'handleError']);
        register_shutdown_function([self::class, 'handleShutdown']);
    }

    public static function handleException($e) {
        self::log($e->getMessage(), $e->getFile(), $e->getLine(), get_class($e), $e->getTraceAsString());
        self::sendEmail($e);
    }

    public static function handleError($severity, $message, $file, $line) {
        // Обработка нефатальных ошибок (E_WARNING и т.д.)
        self::log($message, $file, $line, $severity);
        return true; // предотвращаем стандартный обработчик
    }

    public static function handleShutdown() {
        $error = error_get_last();
        if ($error && in_array($error['type'], [E_ERROR, E_PARSE, E_CORE_ERROR, E_COMPILE_ERROR])) {
            self::log($error['message'], $error['file'], $error['line'], $error['type']);
            // Попытка получить стек через xdebug
            if (function_exists('xdebug_get_function_stack')) {
                $stack = xdebug_get_function_stack();
                self::appendStackToLog($stack);
            }
            self::sendEmail($error);
        }
    }

    private static function log($message, $file, $line, $type, $trace = '') {
        $date = date('Y-m-d H:i:s');
        $entry = "[$date] Тип: $type | $message в $file:$line\n";
        if ($trace) {
            $entry .= "Стек:\n$trace\n";
        }
        file_put_contents(self::$logFile, $entry, FILE_APPEND | LOCK_EX);
    }

    private static function appendStackToLog($stack) {
        $entry = "Стек вызовов (Xdebug):\n";
        foreach ($stack as $frame) {
            $entry .= sprintf("  %s(%s) at %s:%s\n",
                $frame['function'] ?? 'unknown',
                implode(', ', $frame['params'] ?? []),
                $frame['file'] ?? 'unknown',
                $frame['line'] ?? '0'
            );
        }
        file_put_contents(self::$logFile, $entry, FILE_APPEND | LOCK_EX);
    }

    private static function sendEmail($error) {
        $subject = 'Критическая ошибка на сайте';
        $body = print_r($error, true);
        mail(self::$email, $subject, $body);
    }
}

// Регистрация обработчиков
ErrorHandler::register();

// Тестовая фатальная ошибка
echo $undefinedVar;
?>

Результат (содержимое лог-файла):

[2023-05-15 12:34:56] Тип: 8 | Undefined variable: undefinedVar в /var/www/index.php:44
[2023-05-15 12:34:56] Тип: 1 | Call to undefined function foo() в /var/www/index.php:47
Стек вызовов (Xdebug):
  {main}() at /var/www/index.php:47

<?php
// Использование Xdebug для трассировки в файл (без программирования)
// Настройки в php.ini:
xdebug.auto_trace = On
xdebug.trace_output_dir = /var/log/xdebug_traces
xdebug.collect_params = 4
xdebug.collect_return = On
// После этого при каждом запросе будет создаваться файл трассировки
// При фатальной ошибке стек будет в этом файле.
?>

Результат: файл трассировки, например trace.1234567890.xt содержит полный стек вызовов, включая параметры и возвращаемые значения.

TRACE START [2023-05-15 12:35:00]
    0.0001    123456    -> {main}() /var/www/index.php:0
    0.0002    123456    -> test() /var/www/index.php:5
    0.0003    123456    -> strpos() /var/www/index.php:6
    0.0004    123456    -> trigger_error() /var/www/index.php:7
    0.0005    123456    -> exit() /var/www/index.php:7
TRACE END   [2023-05-15 12:35:00]

<?php
ini_set('log_errors', '1');
ini_set('error_log', 'syslog');

register_shutdown_function(function() {
    $error = error_get_last();
    if ($error && in_array($error['type'], [E_ERROR, E_PARSE])) {
        syslog(LOG_CRIT, "Фатальная ошибка: {$error['message']} в {$error['file']}:{$error['line']}");
    }
});

// Тест
include 'nonexistent.php';
?>

Результат: запись в системный лог (например, /var/log/syslog или /var/log/messages).

May 15 12:36:00 server php[12345]: Фатальная ошибка: require(nonexistent.php): failed to open stream: No such file or directory в /var/www/index.php:10