PHP当前如何获取错误时刻的已定义变量及带参数的调试回溯？

背景 #

旧版本PHP的自定义错误处理器会接收所有已定义变量和栈信息：

function myHandler($errno, $errstr, $errfile, $errline, $vars, $trace)
{
 .....  
}

set_error_handler("myHandler");

后来机制变更，错误处理器改为接收包含可访问变量的$errcontext参数：

function myHandler($errno, $errstr, $errfile, $errline, $errcontext)
{
 .....  
}

但目前$errcontext已被废弃不可用，甚至debug_backtrace()返回的回溯信息也不包含函数参数：

[
    {
        "file": "/var/www/includes/dbFunci.inc.php",
        "line": 133,
        "function": "query",
        "class": "mysqli",
        "type": "->"
    },
    {
        "file": "/var/www/includes/dbFunci.inc.php",
        "line": 740,
        "function": "performQuery"
    },
    {
        "file": "/var/www/includes/auditFunc.inc.php",
        "line": 293,
        "function": "insertSQLRow"
    },
    {
        "file": "/var/www/inscubator.cz/pinsFunc.inc.php",
        "line": 92,
        "function": "writeAudit2"
    },
    {
        "file": "/var/www/inscubator.cz/savePin.php",
        "line": 44,
        "function": "savePin"
    }
]

问题 #

如今如何获取错误发生时刻的已定义变量及带参数的调试回溯？

可行解决方案 #

1. 让debug_backtrace()返回参数信息 #

默认情况下debug_backtrace()可能不包含参数，你需要显式传入选项来启用：

// 获取完整带参数的调用栈
$fullTrace = debug_backtrace(DEBUG_BACKTRACE_PROVIDE_OBJECT);

每个栈帧的args字段会包含函数调用时的参数数组。如果需要限制回溯深度，第二个参数传入对应的数值即可。

2. 错误转异常捕获上下文 #

通过set_error_handler()将普通错误转换为ErrorException，异常对象自带的回溯信息默认包含参数，同时在捕获块中可以用get_defined_vars()获取当前作用域的所有变量：

set_error_handler(function(int $errno, string $errstr, string $errfile, int $errline): bool {
    throw new ErrorException($errstr, 0, $errno, $errfile, $errline);
});

try {
    // 执行业务代码
} catch (ErrorException $e) {
    // 带参数的回溯
    $trace = $e->getTrace();
    // 当前所有已定义变量
    $currentVariables = get_defined_vars();
    // 处理错误日志或排查逻辑
}

注意：E_ERROR、E_PARSE这类致命错误无法通过这种方式捕获，需要依赖扩展或PHP的错误日志。

3. 借助调试扩展 #

• Xdebug：开启后自动增强debug_backtrace()的输出，包含详细参数和变量信息，同时会生成带上下文的错误页面。核心配置项：

  xdebug.mode=debug
  xdebug.show_exception_trace=1
  xdebug.dump_globals=on
  

• Tracy：轻量级调试库，集成后能自动捕获错误并展示包含变量、带参数调用栈的调试面板，开发环境下非常实用。

4. 关键路径手动埋点记录 #

在核心函数或易出错的代码段，提前记录变量和调用信息，出错时直接使用：

function insertSQLRow(array $data) {
    // 预存上下文信息
    $debugInfo = [
        'inputData' => $data,
        'caller' => debug_backtrace(DEBUG_BACKTRACE_PROVIDE_OBJECT, 1)[0] ?? []
    ];
    try {
        // 数据库插入逻辑
    } catch (Throwable $e) {
        // 输出包含上下文的错误日志
        error_log(sprintf(
            "Insert failed: %s | Context: %s | Trace: %s",
            $e->getMessage(),
            json_encode($debugInfo),
            $e->getTraceAsString()
        ));
        throw $e;
    }
}

这种方式针对性强，不会带来全局性能损耗。

内容的提问来源于stack exchange，提问作者user3523426