PHP最大执行时间超时：如何获取终止代码的调用栈

问题原因 #

当PHP触发Fatal error: Maximum execution time exceeded错误时，会立即终止当前执行流程并销毁原有调用栈上下文，此时register_shutdown_function中调用的debug_print_backtrace()只能获取到shutdown函数自身的调用栈，无法拿到超时发生时的执行栈信息。

可行解决方案 #

方案1：利用Ticks追踪实时调用栈 #

通过declare(ticks=N)语句，让PHP每执行N条语句就触发一次注册的追踪函数，实时更新并保存当前调用栈。当超时发生时，shutdown函数中即可读取最后一次记录的调用栈。

示例代码：

set_time_limit(2);

// 全局变量存储最新调用栈
$latest_backtrace = [];

// 每执行1条语句触发一次追踪函数（可根据性能调整ticks值，如100）
declare(ticks=1);
register_tick_function('track_backtrace');

// 注册shutdown函数输出结果
register_shutdown_function('print_timeout_backtrace');

fun();

function fun()
{
    while (true)
        ; // 超时发生位置
}

function track_backtrace()
{
    global $latest_backtrace;
    // 排除追踪函数自身的调用栈记录
    $latest_backtrace = array_slice(debug_backtrace(), 1);
}

function print_timeout_backtrace()
{
    global $latest_backtrace;
    if (!empty($latest_backtrace)) {
        echo "超时错误发生时的调用栈:\n";
        foreach ($latest_backtrace as $index => $frame) {
            echo "#{$index} {$frame['function']}() 在 {$frame['file']} 第{$frame['line']}行\n";
        }
    }
}

注意：ticks值越小，追踪越精准，但性能消耗越大，可根据实际场景调整。

方案2：使用PCNTL扩展（CLI/支持PCNTL的环境） #

通过创建子进程执行业务代码，父进程监控子进程运行时间，超时后利用系统工具获取子进程的调用栈。该方案适用于CLI环境或开启PCNTL扩展的服务器环境。

示例代码：

if (extension_loaded('pcntl')) {
    $pid = pcntl_fork();
    if ($pid === 0) {
        // 子进程执行业务逻辑
        set_time_limit(2);
        fun();
        exit(0);
    } else {
        $start_time = time();
        $status = 0;
        // 循环监控子进程状态
        while (pcntl_waitpid($pid, $status, WNOHANG) === 0) {
            if (time() - $start_time > 2) {
                // 超时后获取子进程调用栈（需系统支持pstack/gdb）
                $backtrace = shell_exec("pstack {$pid}");
                echo "超时错误调用栈:\n{$backtrace}";
                // 终止子进程
                posix_kill($pid, SIGKILL);
                break;
            }
            sleep(1);
        }
    }
} else {
    echo "PCNTL扩展未启用，无法使用该方案";
}

function fun()
{
    while (true)
        ; // 超时发生位置
}

注意：该方案依赖系统工具（如pstack），且需要相应执行权限。

方案3：查看PHP错误日志 #

默认情况下，PHP会将致命错误信息记录到错误日志中，日志里包含错误发生的文件和行号。虽然没有完整调用栈，但可用于快速定位超时的大致位置。错误日志路径可通过php.ini中的error_log配置项查看。

内容的提问来源于stack exchange，提问作者Annie W.