README

一个可扩展的类，包含 PHP 调用栈，除了最后 n 步，以避免显示日志的跟踪信息。

用法

composer require kba-team/php-backtrace

示例 1

使用静态函数 classicString() 输出经典的调用栈输出，同时从文件路径中移除当前目录。

<?php
require_once 'vendor/autoload.php';

use kbATeam\PhpBacktrace\ClassicBacktrace;

class Foo {
    public function __construct($a, $b)
    {
        $this->bar(true, 10.2);
    }
    public function bar($c, $d)
    {
        static::baz(404);
    }
    public static function baz($e)
    {
        echo 'Remove __DIR__:' . PHP_EOL;
        echo ClassicBacktrace::classicString(null, __DIR__) . PHP_EOL;
    }
}
new Foo('Hello', 'World');

输出

Remove __DIR__:
#0  Foo::baz(404) called at [test.php:13]
#1  Foo->bar(true, 10.2) called at [test.php:9]
#2  Foo->__construct(Hello, World) called at [test.php:21]

示例 2

创建一个 ClassicBacktrace 实例，并从调用栈中移除最后两步。
输出与示例 1 相同。

<?php
require_once 'vendor/autoload.php';

use kbATeam\PhpBacktrace\ClassicBacktrace;

class Foo {
    public function __construct($a, $b)
    {
        $this->bar(true, 10.2);
    }
    public function bar($c, $d)
    {
        static::baz(404);
    }
    public static function baz($e)
    {
        echo 'Increase offset by 2 steps:' . PHP_EOL;
        echo (new ClassicBacktrace(2))->getClassicString() . PHP_EOL;
    }
}
new Foo('Hello', 'World');

输出

Increase offset by 2 steps:
#0  Foo->__construct(Hello, World) called at [/app/test.php:21]

示例 3

获取调用栈中任何一步的详细信息。

<?php
require_once 'vendor/autoload.php';

use kbATeam\PhpBacktrace\Backtrace;

class Foo {
    public function __construct($a, $b)
    {
        $this->bar(true, 10.2);
    }
    public function bar($c, $d)
    {
        static::baz(404);
    }
    public static function baz($e)
    {
        echo 'Class and line of last trace step:' . PHP_EOL;
        $trace = new Backtrace(null, __DIR__);
        printf(
            'class: %s, line: %u%s',
            $trace->lastStep('class'),
            $trace->lastStep('line'),
            PHP_EOL
        );
        echo PHP_EOL . 'Function and params of trace step before the last:' . PHP_EOL;
        printf(
            'function: %s, params: %s%s',
            $trace->getStep(1, 'function'),
            implode(', ', $trace->getStep(1, 'args')),
            PHP_EOL
        );
    }
}
new Foo('Hello', 'World');

输出

Class and line of last trace step:
class: Foo, line: 13

Function and params of trace step before the last:
function: bar, params: 1, 10.2