Стек вызовов ошибки PHP: инструменты и техники анализа

Как быстро вывести стек на экран без ручного форматирования?

Для быстрого вывода существует функция debug_print_backtrace(). Она сразу печатает стек в стандартный поток вывода. Пример:

function test($x) {
    debug_print_backtrace();
}
test(42);

#0  test(42) called at [/path/to/file.php:4]

Этот метод удобен для временной отладки, но не позволяет сохранить результат в переменную. Для логирования можно использовать буферизацию вывода через ob_start() и ob_get_clean().

Как получить стек из объекта исключения при catch?

При перехвате исключения PHP предоставляет методы getTrace() (массив) и getTraceAsString() (строка). Пример:

try {
    throw new \Exception("Тестовое исключение");
} catch (\Exception $e) {
    echo $e->getTraceAsString();
}

#0 /path/to/file.php(3): {main}

Метод getTraceAsString() возвращает готовую строку, которую можно записать в лог. Однако она не включает аргументы функций по умолчанию. Для более детального анализа используйте getTrace().

Как создать собственный обработчик ошибок с захватом стека?

Установка пользовательского обработчика через set_error_handler() и set_exception_handler() позволяет перехватывать любые ошибки и исключения, логируя стек. Пример для ошибок уровня E_WARNING:

function myErrorHandler($severity, $message, $file, $line) {
    if (!(error_reporting() & $severity)) return false;
    $trace = debug_backtrace(DEBUG_BACKTRACE_IGNORE_ARGS);
    // первый элемент - сам обработчик, удаляем его
    array_shift($trace);
    error_log("Ошибка: $message в $file:$line\n" . print_r($trace, true));
    return true;
}
set_error_handler('myErrorHandler');
trigger_error("Пример ошибки", E_USER_WARNING);

Важно: set_error_handler не перехватывает фатальные ошибки (E_ERROR, E_PARSE). Для них нужен register_shutdown_function и error_get_last().

Как получить стек после фатальной ошибки с помощью shutdown-функции?

Фатальные ошибки не передаются в set_error_handler. Для их перехвата используется register_shutdown_function вместе с error_get_last(). Пример:

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])) {
        $trace = debug_backtrace();
        echo "Фатальная ошибка: {$error['message']}\n";
        print_r($trace);
    }
});
// Вызов несуществующей функции для демонстрации
undefinedFunction();

Внимание: в shutdown-функции контекст исполнения уже разрушен, поэтому debug_backtrace покажет только саму shutdown-функцию. Для получения реального стека фатальной ошибки необходимо использовать расширение Xdebug или логирование через пользовательский обработчик для менее критичных ошибок.

Как использовать Xdebug для расширенного стека вызовов?

Расширение Xdebug предоставляет гораздо более подробный стек вызовов, включая аргументы, переменные и вложенность. При включении xdebug.show_exception_trace и xdebug.var_display_max_depth стек становится интерактивным. Пример настройки в php.ini:

zend_extension=xdebug.so
xdebug.mode=develop
xdebug.show_exception_trace=1
xdebug.var_display_max_depth=5

После этого все исключения будут выводиться с детальным стеком и значениями переменных. Для кастомного логирования можно использовать xdebug_get_function_stack():

function test() {
    $stack = xdebug_get_function_stack();
    var_dump($stack);
}
test();

Как записать стек вызовов в файл лога?

Для долгосрочного анализа удобно сохранять стек в лог. Пример с использованием error_log() и пользовательского обработчика:

function logError($severity, $message, $file, $line) {
    $trace = debug_backtrace(DEBUG_BACKTRACE_IGNORE_ARGS);
    array_shift($trace); // убираем текущий обработчик
    $log = "[" . date('Y-m-d H:i:s') . "] $message in $file:$line\n";
    foreach ($trace as $i => $call) {
        $log .= "#$i {$call['file']}({$call['line']}): ";
        $log .= ($call['class'] ?? '') . ($call['type'] ?? '') . $call['function'] . "()\n";
    }
    error_log($log, 3, '/var/log/php_errors.log');
}
set_error_handler('logError');

Такой подход позволяет централизованно собирать информацию об ошибках. Для production часто используют интеграцию с Monolog.

Как получить стек только для определённого участка кода?

Иногда нужно получить стек не в момент ошибки, а в произвольном месте для понимания последовательности вызовов. Для этого достаточно вызвать debug_backtrace() в нужной точке. Пример для отслеживания рекурсии:

function factorial($n) {
    if ($n <= 1) {
        $trace = debug_backtrace();
        echo "Базовый случай, стек:\n";
        print_r($trace);
        return 1;
    }
    return $n * factorial($n - 1);
}
factorial(3);

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