PHPdebug_print_backtrace()函数

示例1：基本用法

演示最基本的调用方式：

<?php
function testA() {
    testB();
}

function testB() {
    testC();
}

function testC() {
    echo "<pre>";
    debug_print_backtrace();
    echo "</pre>";
}

testA();

输出示例：

#0 testC() called at [/path/to/file.php:10]
#1 testB() called at [/path/to/file.php:5]
#2 testA() called at [/path/to/file.php:15]

示例2：在类方法中使用

演示在类的方法中如何使用：

<?php
class User {
    public function login() {
        $this->validate();
    }

    private function validate() {
        $this->checkCredentials();
    }

    private function checkCredentials() {
        echo "<div style='background:#f5f5f5; padding:10px;'>";
        echo "<strong>调用堆栈:</strong><br>";
        debug_print_backtrace();
        echo "</div>";
    }
}

$user = new User();
$user->login();

输出示例：

调用堆栈:
#0 User->checkCredentials() called at [/path/to/file.php:12]
#1 User->validate() called at [/path/to/file.php:6]
#2 User->login() called at [/path/to/file.php:23]

示例3：使用参数限制

使用$limit参数限制输出帧数，使用$options忽略参数：

<?php
function level1($param1) {
    level2($param1, 'test');
}

function level2($p1, $p2) {
    level3($p1, $p2, [1, 2, 3]);
}

function level3($a, $b, $c) {
    echo "<h4>1. 完整回溯（包含参数）:</h4>";
    debug_print_backtrace();

    echo "<h4>2. 限制3层（包含参数）:</h4>";
    debug_print_backtrace(0, 3);

    echo "<h4>3. 忽略参数:</h4>";
    debug_print_backtrace(DEBUG_BACKTRACE_IGNORE_ARGS);

    echo "<h4>4. 忽略参数且限制2层:</h4>";
    debug_print_backtrace(DEBUG_BACKTRACE_IGNORE_ARGS, 2);
}

level1('start');

示例4：在异常处理中使用

在try-catch块中打印异常时的调用堆栈：

<?php
function processOrder($orderId) {
    if (!is_numeric($orderId)) {
        throw new InvalidArgumentException("订单ID必须是数字");
    }
    // 处理订单逻辑
    echo "订单 {$orderId} 处理成功";
}

function handleRequest($data) {
    try {
        processOrder($data['order_id']);
    } catch (Exception $e) {
        echo "<div style='color: red; border: 1px solid red; padding: 10px; margin: 10px 0;'>";
        echo "<strong>错误:</strong> " . $e->getMessage() . "<br><br>";
        echo "<strong>调用堆栈:</strong><br>";
        debug_print_backtrace();
        echo "</div>";
    }
}

// 测试调用
$requestData = ['order_id' => 'ABC123']; // 非数字ID
handleRequest($requestData);

示例5：自定义错误处理器

在自定义错误处理器中使用debug_print_backtrace()：

<?php
function customErrorHandler($errno, $errstr, $errfile, $errline) {
    echo "<div style='background: #ffe6e6; border-left: 4px solid red; padding: 10px; margin: 10px 0;'>";
    echo "<strong>错误类型:</strong> " . $errno . "<br>";
    echo "<strong>错误信息:</strong> " . $errstr . "<br>";
    echo "<strong>错误文件:</strong> " . $errfile . "<br>";
    echo "<strong>错误行号:</strong> " . $errline . "<br><br>";
    echo "<strong>调用堆栈:</strong><br>";

    // 打印调用堆栈
    debug_print_backtrace(DEBUG_BACKTRACE_IGNORE_ARGS);

    echo "</div>";

    // 不执行PHP内置错误处理器
    return true;
}

// 设置自定义错误处理器
set_error_handler("customErrorHandler");

// 触发错误
function divide($a, $b) {
    if ($b == 0) {
        trigger_error("除数不能为零", E_USER_WARNING);
        return false;
    }
    return $a / $b;
}

function calculate() {
    $result = divide(10, 0);
    return $result;
}

// 调用链
function processCalculation() {
    $value = calculate();
    return $value;
}

processCalculation();

示例6：输出到文件

使用输出缓冲将debug_print_backtrace()的结果保存到文件：

<?php
function logBacktrace($message = '') {
    // 开始输出缓冲
    ob_start();

    if (!empty($message)) {
        echo "== " . date('Y-m-d H:i:s') . " ==\n";
        echo "消息: " . $message . "\n";
        echo "堆栈追踪:\n";
    }

    // 打印回溯信息到缓冲区
    debug_print_backtrace(DEBUG_BACKTRACE_IGNORE_ARGS);

    // 获取缓冲区内容
    $backtrace = ob_get_clean();

    // 写入日志文件
    file_put_contents('trace.log', $backtrace . "\n", FILE_APPEND);

    // 也输出到屏幕（可选）
    echo "<pre>已记录追踪信息到日志文件</pre>";
}

function processUserData($data) {
    if (empty($data['name'])) {
        logBacktrace("用户名为空");
        return false;
    }
    // 处理数据...
    return true;
}

function validateInput($input) {
    return processUserData($input);
}

function handleFormSubmission() {
    $data = ['email' => 'test@example.com']; // 缺少name字段
    validateInput($data);
}

handleFormSubmission();