php8.5
Home/ Manual/ errorfunc / functions/ debug_print_backtrace

debug_print_backtrace

PHP function Edit on GitHub ✎

(PHP 5, PHP 7, PHP 8)

Prints a backtrace

Description

debug_print_backtrace(int $options = 0, int $limit = 0): void

debug_print_backtrace() prints a PHP backtrace. It prints the function calls, include()d/require()d files and eval()ed stuff.

Parameters

options

This parameter is a bitmask for the following options:

DEBUG_BACKTRACE_IGNORE_ARGSWhether or not to omit the "args" index, and thus all the function/method arguments, to save memory.
DEBUG_BACKTRACE_PROVIDE_OBJECTAccepted for compatibility with debug_backtrace(), but has no effect: the generated backtrace is rendered as a string and the "object" entry is never printed.
limit

This parameter can be used to limit the number of stack frames printed. By default (limit=0) it prints all stack frames.

Return Values

Void

Examples

debug_print_backtrace() example

php
<?php
// include.php file

function a() {
    b();
}

function b() {
    c();
}

function c(){
    debug_print_backtrace();
}

a();

?>
php
<?php
// test.php file
// this is the file you should run

include 'include.php';
?>

The above example will output something similar to:

output
#0  c() called at [/tmp/include.php:10]
#1  b() called at [/tmp/include.php:6]
#2  a() called at [/tmp/include.php:17]
#3  include(/tmp/include.php) called at [/tmp/test.php:3]

See Also

Source: reference/errorfunc/functions/debug-print-backtrace.xml · from the official PHP manual (php/doc-en)