Получение стека вызовов в PHP: способы и примеры

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

Пример 1: Форматирование стека для лога с удалением чувствительных данных

function cleanTrace() {
    $trace = debug_backtrace();
    foreach ($trace as & $frame) {
        unset($frame['args'], $frame['object']);
    }
    return json_encode($trace, JSON_PRETTY_PRINT);
}

function risky() {
    echo cleanTrace();
}
risky();

[
    {
        "file": "/var/www/example.php",
        "line": 14,
        "function": "risky",
        "class": "",
        "type": "",
        "args": []
    },
    {
        "file": "/var/www/example.php",
        "line": 16,
        "function": "{main}",
        "args": []
    }
]

Пояснение: Удаление аргументов и объектов предотвращает утечку данных. Используется в production логировании.

Пример 2: Стек вызовов через исключение с сохранением предыдущего контекста

function inner(\Throwable $previous = null) {
    throw new \Exception('Inner error', 0, $previous);
}
function outer() {
    try {
        throw new \Exception('Outer error');
    } catch (\Exception $e) {
        inner($e);
    }
}
try {
    outer();
} catch (\Exception $e) {
    echo $e->getTraceAsString();
    echo "\nPrevious:\n";
    echo $e->getPrevious()->getTraceAsString();
}

#0 /path/to/file.php(5): inner()
#1 /path/to/file.php(10): outer()
#2 /path/to/file.php(16): {main}
Previous:
#0 /path/to/file.php(9): outer()
#1 /path/to/file.php(16): {main}

Пояснение: Цепочка исключений позволяет получить стек как текущей точки, так и исходной ошибки.

Пример 3: Рекурсивный обход и фильтрация стека по файлам

function filterTraceByFile($pattern) {
    $trace = debug_backtrace();
    $filtered = [];
    foreach ($trace as $frame) {
        if (isset($frame['file']) && preg_match($pattern, $frame['file'])) {
            $filtered[] = $frame['file'] . ':' . $frame['line'] . ' - ' . $frame['function'];
        }
    }
    return implode("\n", $filtered);
}

class A {
    public function run() { B::test(); }
}
class B {
    public static function test() { echo filterTraceByFile('/vendor/'); }
}
(new A)->run();

// (пусто, так как все файлы не из vendor)

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

Пример 4: Получение стека внутри замыкания со всеми аргументами

$closure = function () {
    $trace = debug_backtrace(DEBUG_BACKTRACE_PROVIDE_OBJECT);
    foreach ($trace as $frame) {
        echo 'Function: ' . $frame['function'] . PHP_EOL;
        if (isset($frame['object'])) {
            echo 'Object class: ' . get_class($frame['object']) . PHP_EOL;
        }
    }
};
class Foo {
    public function bar() {
        $closure = function () {
            $trace = debug_backtrace();
            echo 'Closure trace count: ' . count($trace) . PHP_EOL;
        };
        $closure();
    }
}
$foo = new Foo();
$foo->bar();

Function: {closure}
Object class: Foo
Closure trace count: 2

Пояснение: В замыкании debug_backtrace() может не показывать полный контекст, если объект не передан. Использование флага PROVIDE_OBJECT добавляет объект замыкания.

Пример 5: Использование xdebug_get_function_stack() для детальной информации

// Требуется установленный Xdebug
function detailed() {
    $stack = xdebug_get_function_stack();
    foreach ($stack as $frame) {
        echo $frame['function'] . ' in ' . $frame['file'] . ':' . $frame['line'] . PHP_EOL;
        if (isset($frame['params'])) {
            print_r($frame['params']);
        }
    }
}
function test($a) { detailed(); }
test('hello');

detailed in /path/to/file.php:10
test in /path/to/file.php:14
Array
(
    [a] => 'hello'
)

Пояснение: Xdebug предоставляет аргументы в виде ассоциативного массива с именами параметров, что удобнее чем debug_backtrace().

Пример 6: Стек вызовов в трейте

trait Traceable {
    public function showTrace() {
        $trace = debug_backtrace();
        echo 'Called from: ' . $trace[0]['file'] . ':' . $trace[0]['line'] . PHP_EOL;
    }
}
class MyClass {
    use Traceable;
    public function doSomething() {
        $this->showTrace();
    }
}
$obj = new MyClass();
$obj->doSomething();

Called from: /path/to/file.php:10

Пояснение: Трейты могут использовать debug_backtrace() для определения файла и строки, откуда вызван метод трейта (полезно для логирования).